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PERSONNEL  READINESS  INDICATOR  MODEL  (PRIM) 
PROGRAM  MAINTENANCE  MANUAL 


SECTION  1 

GENERAL  DESCRIPTION 


/  **NT> 


1.1  PURPOSE  OF  PROGRAM  MAINTENANCE  MANUAL.  The  objective  of  the  Program 
Maintenance  Manual  for  the  Personnel  Readiness  Indicator  Model  (PRIM)  is  to 
provide  the  maintenance  programer  with  the  information  necessary  to  effec¬ 
tively  maintain  the  system.  . 

'x 

1.2  PROJECT  REFERENCES  \ 


a.  Study  Directive,  subject:  Personnel  Readiness  Indicator  Model 
(PRIM)  Study,  26  September  1983. 

b.  FORECAST  -  A  study  designed  to  improve  and  replace  many  tne 
enlisted  and  officer  inventory  projections  and  distribution  models. 
FORECAST  does  not  directly  address  personnel  readiness. 

c.  Army  Regulation  220-1,  Unit  Status  Reporting. 

d.  Personnel  Readiness  Indicator  Model  (PRIM)  User  Manual,  CAA-D-84-3. 

e.  Personnel  Readiness  Indicator  Model  (PRIM)  Study  Report, 
CAA-SR-84-5. 


f.  The  referenced  policy  guidance  memorandums  were  used  to  determine 
the  types  of  policies  which  were  modeled  by  PRIM.  The  PRIM  design  is  not 
dependent  upon  the  specific  policies  stated  in  the  following: 

(1)  DCSPER  Memorandum,  subject:  Enlisted  Distribution  Policy 
Guidance,  4  October  1982. 

(2)  OCSOPS  Memorandum,  subject:  Pol  icy  Guidance:  Personnel  Fill  for 
Force  Modernization,  13  September  1982. 

(3)  DCSPER  Letter,  subject:  Officer  Distribution  Policy  Guidance,  FY 
83,  4  October  1982. 

1.3  TERMS  AND  ABBREVIATIONS 


activity  Pay  grade  of  an  MOS  at  a  particular  demand. 

Unit  status  reporting  regulation  for 
reporting  the  current  status  of  selected 
Active  and  Reserve  Component  units. 


AR  220-1 
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arc 

ASCII 

assignment  code 

assignment  policy 
AUDB 

authorized  jobs 

available  MOS  percentage 

available  people 

available  senior-grade 
percentage 

available  strength 

CAA 


The  hypothetical  link  between  the  jobs  and 
personnel  inventory  along  which  the  people 
can  be  sent.  The  number  of  people  assigned 
to  a  specific  job  is  called  the  flow  on  the 
arc. 

American  Standard  Code  for  Information 
Interchange. 

Major  command  or  DA  staff  agency  to  which  the 
unit  is  assigned.  The  abbreviation  is  ASGMT. 

see  personnel  policy. 

Authorization  Data  Base  is  the  MILPERCEN- 
developed  data  base  for  authorizations  by 
UIC,  MOS/SC,  and  grade  for  modification 
tables  of  organization  and  equipment  (MTOE), 
table  of  distribution  and  allowances  (TDA) , 
and  TDA  augmentation  organizations. 

The  number  of  jobs  that  should  be  filled 
during  peacetime.  This  number  is  frequently 
constrained  to  a  smaller  number  of  jobs  than 
the  required  jobs.  Either  authorized  or 
required  jobs  may  be  specified  as  the  jobs 
for  PRIM. 

The  available  MOS-trained  strength  divided  by 
the  structure  MTOE  strength  and  converted  to 
a  percentage. 

Those  personnel  assigned  to  an  ISSUE  and  who 
are  available  for  duty  rather  than  sick,  on 
leave,  or  unavailable  for  duty  for  other 
specified  reasons.  For  complete  list  see 
Appendix  B  of  AR  220-1. 

The  total  number  of  available  commissioned 
officers,  warrant  officers,  and  E-5  to  E-9 
enlisted  grades,  divided  by  the  total 
structure  number  of  commissioned  officers, 
warrant  officers,  and  grades  E-5  to  E-9 
converted  to  a  percentage. 

The  total  available  strength  divided  by  the 
structure  MTOE  strength  and  converted  to  a 
percentage. 

US  Army  Concepts  Analysis  Agency. 
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C-rating 

CAP  III 
demand  , 

DOPMA 

excess  people 

fill 

flow 

goal  percentage 

high  5  or  high  five 

inventory 

ISSUE 

job  data 

MACOM 

MILPERCEN 

MOS 

MTOE 


The  personnel  readiness  rating  for  an  ISSUE 
based  upon  criteria  in  AR  220-1.  It  is  the 
lowest  of  three  ratings:  senior  grade, 
available  MOS-trained,  or  available  strength. 

System  currently  used  for  enlisted  assign¬ 
ments. 

Real  job  or  super  job  to  which  people  must  be 
assigned. 

Defense  Officers  Personnel  Management  Act. 

The  number  of  people,  by  MOS  and  grade  for 
which  there  was  no  demand. 

The  number  of  assignments  made. 

The  number  of  people  assigned  to  a  job. 

The  minimum  percentage  of  total  aggregate 
fill. 

The  highest  five  enlisted  grades,  E-5,  E-6, 
E-7,  E-8,  and  E-9. 

See  projected  personnel  inventories. 

An  aggregation  of  units  for  the  purpose  of 
highlighting  Individual  Systems,  Similar 
Units,  or  Equipment. 

The  jobs  which  will  have  personnel  assigned 
to  them  by  the  assignment  processor.  The 
jobs  are  of  a  specific  MOS  or  SC,  grade 
level,  and  may  be  either  structured  or 
authorized  jobs. 

Major  Army  command. 

US  Army  Military  Personnel  Center. 

Military  occupational  specialty  is  a  code 
representing  the  type  of  skill  in  which 
enlisted  personnel  or  warrant  officers  have 
been  trained  and  should  be  assigned  to 
perform.  Also  used  in  the  PRIM  job  data  file 
to  describe  the  skill  the  person,  whether 
enlisted,  warrant  officer,  or  commissioned 
officer,  assigned  to  a  job  must  possess. 

Modification  Tables  of  Organization  and 
Equipment. 

1- 


number  of  people 


The  set  of  combined  enlisted  and  officer 
personnel  inventory. 


ODCSPER 

OFIP 

P3M 

parameters 
personnel  data 

personnel  policies 

PNET 

projected  MTOE/TDA 
authorizations 

projected  personnel 
inventories 

required  jobs 

SC 

senior  grade 


Office  of  the  Deputy  Chief  of  Staff  for 
Personnel . 

Officer  Force  Implementation  Plan. 

Personnel  Policy  Projection  Model  is  used  by 
MILPERCEN  to  develop  inventories  for  use  as  a 
personnel  data.  It  computes  an  MOS  and  grade 
level,  enlisted  personnel  inventory,  and 
reenlistment  projection  while  taking  into 
consideration  personnel  management  policy 
options. 

Data  values  which  are  specific  to  each  run 
and  must  be  set  by  the  user. 

The  number  of  people  (officers  and  enlisted) 
by  MOS  or  SC  grade  that  MILPERCEN  expects 
will  be  available;  the  output  of  the  P3M 
Model  for  enlisted  personnel,  the  OFIP  for 
commissioned  officer  personnel,  and  the  WOFIP 
for  warrant  officer  personnel. 

In  PRIM,  policies  are  the  statement  of 
minimum  and  maximum  personnel  fill  levels 
which  have  been  in  effect  or  are  being  tested 
prior  to  implementation.  Policies  may  apply 
to  all  MOS,  specific  MOS,  or  specific  grade 
levels.  Policies  modeled  by  PRIM  must  be 
converted  to  computer-readable  format.  See 
personnel  policies. 

A  mathematical  programing  system  for  solving 
network  flow  problems. 

The  number  of  people,  by  specialty  and  grade, 
that  will  be  needed  in  each  unit  (3-digit 
UIC)  at  a  future  time. 

The  number  of  people,  by  specialty  and  grade, 
who  will  be  in  the  Active  Army  at  a  future 
time. 

In  PRIM,  the  jobs  that  should  be  filled.  The 
user  chooses  structure  or  authorized. 

Commissioned  code  officers  specialty. 

Personnel  in  grades  E-5  through  E-9,  WO,  and 
01  through  06. 
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structure  strength  The  jobs  that  must  be  filled  if  a  unit  is  to 

achieve  maximum  readiness.  Structure  MTOE 
strengths  are  used  in  PRIM  for  computation  of 
C-ratings,  IAW  AR  220-1. 

super  job  Imaginary  job  where  personnel  are  assigned 

when  no  "real"  jobs  are  left  to  be  filled. 

super  soldier  Imaginary  person  assigned  to  job  when  no 

person  fitting  requirements  is  available. 

Also  known  as  super  person. 

TOA  Table  of  distribution  and  allowance. 

UIC  Unit  identification  code.  Although  the  UIC 

is  normally  six  characters,  the  PRIM  UIC  is 
the  "3-digit  UIC"  (characters  2-4  of  UIC) 
unless  otherwise  stated. 

unavailable  factors  A  standard  factor  representing  the  percentage 

of  people  not  available  for  duty,  input 
through  the  parameter  file. 

unfilled  jobs  The  jobs  that  have  not  had  people  assigned  by 

PRIM. 

WOFIP  Warrant  Officer  Force  Implementation  Plan. 
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SECTION  2 


SYSTEM  APPLICATION 


2.1  SYSTEM  DESCRIPTION.  The  introduction  of  new  organizational  systems 
into  the  Army  generates  major  changes  in  the  force  structure.  Assigning 
properly  trained  soldiers  in  a  timely  manner,  coinciding  with  the  fieldirnj 
of  new  equipment,  requires  intense  management  and  long  lead  times.  The 
personnel  inventories  required  to  operate  future  systems  are,  therefore, 
the  product  of  today's  decisions  to  commit  resources;  data  for  these  deci¬ 
sions  should  include  knowledge  of  future  requirements.  To  this  end,  deci¬ 
sionmakers  require  a  tool  with  which  to  assess  the  Army's  ability  to  pro¬ 
vide  personnel  support  for  the  modernization  process.  The  US  Army  Military 
Personnel  Center  (MILPERCEN)  can  currently  project  inventories  by  military 
occupational  speciality/speciality  code  (MOS/SC)  and  grade  for  the  total 
Active  component  of  the  Army.  However,  there  is  not  an  adequate  system  for 
evaluating  the  impact  of  personnel  policy  changes  on  the  future  levels  of 
personnel  fill  in  units.  As  a  result,  conflicting  guidance  may  be  issued 
and  personnel  policies  may  not  be  developed  providing  the  highest  potential 
level  of  personnel  readiness  on  a  global  basis. 

There  is  currently  no  way  to  link  macro-level  MOS  projections  to  unit- 
level  predictions  for  readiness  rating  in  the  same  period.  PRIM  will  aid 
in  determining  the  effects  of  various  end  strengths  and  distribution 
policies  on  unit  readiness  postures  by  showing  the  increase  or  decrease  of 
the  personnel  fills,  and  the  resulting  C-ratings  based  on  parameters  in  AR 
220-1  (e.g.,  top  three  NCO  levels  and  total  fills).  The  PRIM  distributes 
projections  of  Active  Army  personnel  strengths  by  grade  and  specialty  to 
units  and  logical  groups  of  units.  The  PRIM  reports  provide  the  personnel 
readiness  measures  specified  in  AR  220-1.  In  addition,  other  personnel 
information  such  as  projected  unit  fill  percentages  is  provided. 

AR  220-1  specifies  three  types  of  readiness:  training,  equipment,  and 
personnel.  The  Personnel  Readiness  Indicator  Model  predicts  unit  personnel 
readiness  status.  Recently,  CAA  developed  a  model  for  the  Office  of  the 
Deputy  Chief  of  Staff  for  Logistics  (00CSL0G)  called  E-DATE  to  model  equip¬ 
ment  readiness,  and  PRIM  will  model  personnel  readiness  for  the  Office  of 
the  Deputy  Chief  of  Staff  for  Personnel  (ODCSPER).  Currently,  there  is  no 
model  for  training  readiness. 

2.2  SECURITY  AND  PRIVACY 

a.  Security.  All  program  code  and  listings  are  considered  UNCLASSIFIED 
and  require  no  special  security  considerations.  Outputs  will  be  classified 
at  the  same  level  as  the  classification  of  the  unit  aggregation  specifi¬ 
cations.  In  normal  use,  these  will  be  UNCLASSIFIED. 

b.  Privacy.  The  personnel  data  used  as  input  to  PRIM  is  output  of  an 
inventory  projection  model  and  does  not  contain  information  on  individual 
people.  Therefore,  this  section  is  not  applicable. 
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2.3.  GENERAL  DESCRIPTION.  The  PRIM  is  divided  into  six  separate  free¬ 
standing  processors  that  are  executed  sequentially  in  a  batch  environment 
to  produce  the  final  reports.  Figure  2-1  shows  the  system  organization. 
Results  of  all  processors  are  stored  in  mass  storage  files.  The  complete 
PRIM  system  consists  of  6  program  files,  2  runstream  files,  and  62  data 
files.  Many  of  the  files  may  be  temporary  files,  and  no  runstream  will 
require  that  all  files  are  resident  at  one  time.  A  complete  run  of  PRIM 
requires  a  minimum  of  12  separate,  sequential  runs.  The  user  may  choose  to 
run  these  as  one  long  runstream  of  executions  or  to  run  each  separately, 
correcting  input  errors  and  rerunning  prior  to  attempting  the  next  step.  A 
list  of  the  errors  recognized  by  the  Preprocessor  and  the  Policy  Processor 
will  be  found  in  Appendix  E. 

a.  The  initial  processor,  the  Preprocessor,  creates  the  PRIM  data  base 
by  rolling  the  UlC-level  information  on  projected  jobs  into  ISSUE-level 
information  to  create  the  MOS-data  file  which  contains  the  demand  (job) 
data.  (ISSUE  is  further  discussed  in  Appendix  C.)  The  Preprocessor 
contains  four  main  programs  and  nine  subroutines,  plus  utility  programs. 

The  function  of  each  of  these  routines  is  explained  in  the  Program 
Description,  subsection  2.4. 

b.  The  second  processor,  the  Policy  Processor,  performs  three  func¬ 
tions.  First,  it  edits  the  user-prepared  Policy  file.  Then  it  applies  the 
personnel  policies  to  the  MOS-data  file,  rewriting  the  applicable  records 
with  the  minimum  and  maximum  fill  levels  and  assignment  values  to  the  Job 
Assignment  Value  (JAV)  file  which  is  needed  by  the  Assignment  Processor. 
Finally,  the  remaining  MOS-data  records  are  rewritten  using  information 
from  the  Value  file.  Since  the  time  required  to  run  all  segments  of  the 
Policy  Processor  could  be  an  hour  or  more,  depending  upon  the  size  of  the 
input  MOS-data  file  and  the  number  of  policies,  and  since  the  user  may  want 
to  make  changes  to  the  Policy  and  Value  files,  the  Policy  Processor  is 
designed  to  run  as  a  set  of  five  independent,  sequential  runs.  These  runs 
use  5  main  programs  and  35  subroutines.  The  Policy  and  Value  files  are 
described  in  Appendix  C;  the  Policy  Processor  is  described  in  detail  in 
section  2.5. 

c.  The  third  processor,  the  Assignment  Processor  contains  1  main  pro¬ 
gram,  5  major  subroutines,  and  10  other  subroutines.  The  Assignment 
Processor  uses  the  Number-of-People  file  and  the  Job  Assignment  Value  file 
to  create  the  data  it  requires  for  generating  the  personnel  assignments. 

The  Assignment  Processor  converts  the  input  files  to  network  input  format, 
makes  the  personnel  assignments,  and  saves  the  assignment  results  for  each 
specialty  separately,  cycling  through  all  steps  for  each  MOS  or  SC.  The 
programs  are  described  in  section  2.6. 

d.  The  fourth  processor,  the  Substitute  Assignment  Processor,  assigns 
excess  personnel  to  unfilled  jobs.  This  processor  consists  of  two  modules, 
one  which  assigns  using  grade  substitutions  and  one  which  assigns  using 
specialty  substitutions.  The  processing  in  each  module  is  similar  to  the 
other  and  to  the  Assignment  Processor;  the  network  portion  is  duplicated  in 
each.  See  section  2.7  for  the  detailed  program  description. 
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e.  The  fifth  processor,  the  Readiness  Processor,  applies  the  criteria 
from  AR  220-1  to  develop  the  readiness  measures  and  computes  additional 
indicators  for  use  by  MILPERCEN.  The  processing  is  explained  in  the 
Program  Description,  subsection  2.8. 

f.  The  final  processor,  the  Report  Processor,  provides  a  variety  of 
user  designed  reports.  More  detail  will  be  found  in  section  2.9. 

g.  Several  utility- type  subroutines  are  used  by  more  than  one 
processor.  Examples  of  the  functions  performed  by  these  subroutines  are: 

(1)  Convert  the  run  date  to  readable  format. 

(2)  Convert  alphanumerics  to  integer  or  to  a  real  number. 

(3)  Write  a  message  to  the  Error  Print  file. 

(4)  Temporarily  modify  the  system  to  allow  ASCII  FORTRAN  to  read  and 
write  file  numbers  from  zero  through  99. 

2.4  PROGRAM  DESCRIPTION  -  PREPROCESSOR.  The  Preprocessor  consists  of  a 
set  of  three  subprocessors,  one  of  which  has  been  further  divided  into  two 
modules.  Therefore,  a  complete  run  of  the  processor  requires  running  four 
separate  programs  plus  three  sorts  using  the  SORT  utility  program.  Sub¬ 
section  2.4  contains  a  description  of  the  four  modules  of  the  Preprocessor. 
In  addition  to  the  four  main  programs,  one  for  each  module,  nine  sub¬ 
routines  are  associated  with  the  third  module.  A  complete  listing  of  the 
programs  discussed  in  subsection  2.4  is  contained  below.  Subroutines  named 
as  called  in  the  program  descriptions,  but  not  listed  below,  are  PRIM 
utility  routines  which  are  described  in- subsection  2.10  or  UNIVAC  ASCII 
FORTRAN  utilities. 


Paragraph 

Program 

Process 

Short  description 

2.4.1 

ROLUIC 

1.1.1 

Main  program  for  module  1 

2.4.2 

ROLMOS 

1.1.2 

Main  program  for  module  2 

2.4.3 

DRIV12 

1.2 

Main  program  for  module  3 

2. 4. 3.1 

SETTPS 

1.2.1 

Set  TPSN  ISSUES 

2. 4. 3. 2 

SETUIC 

1.2.2 

Set  UIC  ISSUES 

2. 4. 3. 3 

SETASG 

1.2.3 

Set  ASGMT  ISSUES 

2. 4. 3. 4 

AGGUIC 

1.2.4 

Aggregate  UlC-data 

2. 4. 3. 5 

SETMOS 

1.2.5 

Set  MOS-data  ISSUES 

2. 4. 3. 6 

CHKNUL 

Util 

Preprocessor  utility 

2. 4. 3. 7 

D0IT12 

Util 

Preprocessor  utility 

2. 4. 3. 8 

DOITNO 

Util 

Preprocessor  utility 

2. 4. 3. 9 

ISSFIN 

Util 

Preprocessor  utility 

2.4.4 

DR  I V 1 3 

1.3 

Main  program  for  module  4 

2. 4. 4.1 

AGGMOS 

1.3.1 

Aggregate  MOS-data 

V 
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The  functions  performed  by  the  Preprocessor  are: 

a.  Process  1.1.  Roll  or  Aggregate  Data  (two  separate  modules) 

(1)  Process  1.1.1.  Roll  UIC  -  This  subprocessor  rolls 
(aggregates)  the  unit  information  (from  the  header  record  of  the 
Authorization  Data  Base)  from  six-digit  Unit  Identification  Code 
(UIC)  level  to  three-digit  UIC  level.  This  three-digit  UIC 
information  is  input  to  the  subprocessor  1.2,  Set  ISSUE.  Prior  to 
this  program,  the  header  information  should  be  sorted  on  three- 
digit  UIC.  Be  sure  to  use  correct  options,  i.e.,  Fielddata  or 
ASCII. 

(2)  Process  1.1.2.  Roll  MOS  -  This  subprocessor  rolls  the  detail 
infor-mation  from  the  Authorization  Data  Base  from  the  six-digit 
UIC  level  to  the  three-digit  UIC  level.  The  information  at  the 
three-digit  level  is  input  to  the  subprocessor  1.2,  Set  ISSUE. 

The  detail  information  should  be  sorted  on  MOS  within  three-digit 
UIC  prior  to  this  program;  the  sort  must  be  tailored  for  the  input 
data,  i.e.,  the  options  will  be  different  depending  upon  whether 
the  MOS-data  file  is  Fielddata  or  ASCII. 

b.  Process  1.2.  Set  ISSUE  -  This  subprocessor  uses  the  ISSUE  file  to 

set  the  ISSUE  code  in  each  UlC-data  record.  The  UlC-data  records 
are  then  matched  with  the  MOS-data  records  on  the  three-digit  UIC 
^  _  and  the  ISSUE  is  set  in  the  MOS-data  records.  The  ISSUE  may  be 

%.•  reset  if  a  UIC  is  included  in  more  than  one  ISSUE  definition 

during  process  1.2.1,  Set  TPSN,  or  process  1.2.2,  Set  UIC.  A 
warning  message  is  written  for  every  UIC  that  is  reset,  each  time 
it  is  reset.  Table  2-1  provides  a  summary  of  the  combinations  of 
variables  in  UlC-data  that  may  be  used  to  identify  ISSUEs.  An 
error  message  is  written  for  every  UIC  that  did  not  have  the  ISSUE 
set.  The  process  sequence  is: 

(1)  Process  1.2.1.  Set  TPSN.  Set  ISSUE  based  on  Troop  Program 
Sequence  Number  (TPSN)  and  Assignment  Code  (ASGMT),  TPSN  and 
Location  Code  (LOCCO),  TPSN  and  Station  Code  (STACO),  and  TPSN 
only. 

(2)  Process  1.2.2.  Set  UIC.  Set  ISSUE  based  on  UIC. 

(3)  Process  1.2.3.  Set  ASGMT.  Set  ISSUE  based  on  ASGMT  and 
LOCCO,  ASGMT  and  STACO,  ASGMT  only,  and  character  one  only  of 
ASGMT. 

(4)  Process  1.2.4.  Aggregate  UIC.  Aggregate  and  print  UIC 
information  at  the  UIC  level.  Outputs  are  Aggregate  Required 
Strength  (AGGREQ),  Aggregate  Authorized  Strength  (AGGAUT),  and  a 
list  of  the  three-digit  UICs  included  in  each  ISSUE.  Note: 

AGGREQ  and  AGGAUT  are  printed  for  information  purposes  but  are  not 

t.  ■-  the  numbers  actually  used  on  the  final  reports.  The  reports  use 

numbers  aggregated  from  the  MOS-data  records.  These  numbers 
should  be  the  same  but  are  not  necessarily  equal. 


•.  «*.  f.  ■ 


A. 
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(5)  Process  1.2.5.  Set  MOS.  Match  the  MOS-data  file  to  the  UlC- 
data  file  on  the  three-digit  UIC.  Set  the  ISSUE  in  the  MOS-data 
file  equal  to  the  ISSUE  on  the  UlC-data  file  record. 

c.  Process  1.3.  Aggregate  MOS.  This  subprocessor  aggregates  the 
MOS-data  to  the  ISSUE  level  and  creates  print  files  containing 
information  that  may  be  required  to  ensure  the  units  have  been 
grouped  appropriately.  The  Aggregate  Required  Strength  and  the 
Aggregate  Authorized  Strength  is  computed  for  each  ISSUE  and 
across  all  ISSUES.  These  may  be  compared  with  the  information 
from  1.2.4,  Aggregate  UIC,  for  an  indication  of  differences 
between  the  UlC-data  and  the  MOS-data.  A  count  of  the  number  of 
specialties  found  for  each  ISSUE  is  printed  and  a  screen-readable 
file  of  aggregate  strengths  for  each  MOS  and  ISSUE  is  created. 
Another  file,  containing  aggregate  strengths  for  each  ISSUE  by 
pay-grade,  is  also  created.  The  MOS-data  file  should  be  sorted  on 
MOS  within  ISSUE  (Major  =  ISSUE,  Minor  =  MOS)  prior  to  running 
this  program.  Since  the  Mos-data  file  was  output  from  sub¬ 
processor  1.1.2,  Roll  MOS,  the  file  is  ASCII,  and  the  sort  options 
must  be  ASCII  options. 


Table  2-1.  ISSUE  Definition 


Processing 

order 

Identification 
Method  1 

Identification 

Method  2 

Warn  and 
reset  if 
not  blank 

1 

TPSN 

ASGMT 

Yes 

2 

TPSN 

LOCCO 

Yes 

3 

TPSN 

STACO 

Yes 

4 

TPSN 

-- 

No 

5 

UIC3 

-- 

Yes 

6 

ASGMT 

LOCCO 

No 

7 

AS  GMT 

STACO 

No 

8 

ASGMT 

-- 

No 

9 

ASGMT 1 

— 

No 

A  set  of  figures  is  provided  to  assist  the  reader  in  better  under¬ 
standing  the  relationship  of  the  main  programs  and  subroutines  in  the 
Preprocessor.  Figure  2-2  shows  the  information  flow  through  the  Pre¬ 
processor;  Figure  2-3  shows  the  structure  of  all  of  the  routines  within  the 
Preprocessor;  Figure  2-3,  along  with  Figure  2-4,  which  is  a  chart  of  the 
subroutine  cross-references  allows  the  reader  to  see  which  routines  are 
called  by  routines  other  than  the  main  programs.  All  these  figures  will  be 
found  at  the  end  of  section  2.4. 
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2.4.1  PROGRAM  DESCRIPTION 

a.  Identification 
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Preprocessor  Main  Program  -  ROLUIC 
Process  Number  1.1.1 

b.  Function 

This  program  aggregates  the  UlC-data  file  from  the  six-digit  UIC  level 
to  the  three-digit  UIC  level. 

c.  Input 

UlC-data  (six-digit  UIC  level)  file  Logical  unit  22 

d.  Processing 

Presort  the  six-digit  UlC-data  file  by  characters  2  through  4  of  the 
UIC;  sort  options  must  match  data  type. 

Add  strengths  from  all  records  which  match  on  characters  2  through  4 
of  the  UIC  and  write  one  record  for  each  set  of  matching  records. 

e.  Output 

UlC-data  (three-digit  UIC  level)  file  Logical  unit  23 

f.  Interfaces 
Called  by:  N/A 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for ’the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  ROLUIC. 
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2.4.2  PROGRAM  DESCRIPTION 

a.  Identification 


Preprocessor  Main  Program  -  ROLMOS 
Process  Number:  1.1.2 

b.  Function 


This  program  aggregates  the  MOS-data  file  from  the  six-digit  UIC  level 
to  the  three-digit  UIC  level. 

c.  Input 


Parameter  file 

MOS  -  Enlisted  file 

MOS  -  Officer  file 

MOS  -  Warrant  Officer  file 


Logical  unit  17 
Logical  unit  26 
Logical  unit  27 
Logical  unit  28 


d.  Processing 


Presort  each  MOS-data  file  by  UIC  and  by  the  maximum  number  of  MOS 
characters  (NCCHAR)  from  the  Parameter  file;  sort  optioms  must  match 
data  type. 


Get  grades  from  Parameter  file. 


Get  lengths  of  MOS  from  Parameter  file. 


Roll  the  MOS-data  file  to  three-digit  UIC  level  and  combine  all  grades 
within  the  same  MOS  and  three-digit  UIC. 


e.  Output 

MOS-data  (three-digit  UIC  level)  file  Logical  unit  29 
Error  Print  file  Logical  unit  13 

f.  Interfaces 


Called  by:  N/A 

Calls  to:  WRTERR  (NERR) 

FSORT  (FORTRAN  sort  utility) 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Codes  in  ROLMOS  are  2,  4,  30,  32,  39,  40, 
42,  126. 
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2.4.3  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Main  Program  -  DR  I V 1 2 
Process  Number:  1.2 

b.  Function 

This  program  calls  the  subroutines  that  make  up  the  ISSUE  file  and 
MOS-data  file  edit  portion  of  the  Preprocessor. 


Logical  unit  14 
Logical  unit  17 
Logical  unit  23 
Logical  unit  29 


c.  Input  (via  subroutines} 

ISSUE  Definition  file 
Parameter  file 

UlC-data  (three-digit  UIC  level)  file 
MOS-data  (three-digit  UIC  level)  file 

d.  Processing 

Get  the  wall  clock  time. 


Get  the  day  the  run  is  being  made. 

Get  the  debug  flag. 

Set  up  the  Error  Print  file. 

Set  the  ISSUEs  that  are  based  on  TPSN. 

Set  the  ISSUEs  that  are  based  on  specific  UICs. 

Set  the  ISSUEs  that  are  based  on  ASGMT. 

If  the  debug  flag  is  set  to  greater  than  9,  do  not  perform  the 
following  two  steps: 

Aggregate  the  UlC-data  file  to  the  ISSUE  level. 

Set  the  ISSUEs  in  the  MOS-data  file  from  the  UlC-data  file. 


e.  Output  (via  subroutines) 

Error  Print  file 

UlC-data  (three-digit  with  ISSUE  added)  file 
UlC-data  (three-digit  with  ISSUE  added)  file 
MOS-data  (three-digit  with  ISSUE  added)  file 


Logical  unit  13 
Logical  unit  24 
Logical  unit  25 
Logical  unit  30 


l 


f.  Interfaces 


Called  by:  N/A 

Calls  to:  GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 

GETDAY  (RUNDAY) 

APRTCA  (PRIM  utility) 

WRTERR  (NERR) 

SETTPS  (IDEBUG,  IOK) 

SETUIC  (IDEBUG,  IOK) 

SETASG  (IDEBUG,  IOK) 

SETMOS  (IDEBUG,  IOK) 

AGGUIC  (IDEBUG,  IOK) 

CHKNUL  (CHKFIE,  LENG) 

DOITNO  (LUNIN,  LUNOUT,  IDEBUG) 

DOIT12  (LUNIN,  LUNOUT,  IDEBUG) 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


h.  Error  Codes.  The  Error  Code  in  DR I V 1 2  is  0  (zero). 
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2.4.3. 1  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Subroutine  -  SETTPS  (IDEBUG,  IOK) 

Process  Number:  1.2.1 

b.  Function 

This  subroutine  sets  the  ISSUE  code  in  the  UlC-data  file  for  those 
units  that  are  grouped  on  TPSN. 

c.  Input 

ISSUE  Definition  file  Logical  unit  14 

UlC-data  (three-digit  level)  file  Logical  unit  23 

d.  Processing 

Sort  ISSUE  file  on  identification  methods. 

Sort  UlC-data  file  on  TPSN/ASGMT. 

Set  ISSUE  when  TPSN  and  ASGMT  match. 

Sort  UlC-data  file  on  TPSN  and  LOCCO. 

Set  ISSUE  when  TPSN  and  LOCCO  match;  write  warning  messages  if  not 
blank. 

Sort  UlC-data  file  on  TPSN  and  STACO. 

Set  ISSUE  when  TPSN  and  STACO  match;  write  warning  messages  if  not 
blank. 

Set  ISSUE  when  TPSN  (only)  matches  (do  not  set  if  had  been  set 
previously) . 

e.  Output 

UlC-data  (three-digit  level  with  ISSUE  added)  file  Logical  unit  24 
UlC-data  (three-digit  level  with  ISSUE  added)  file  Logical  unit  25 
Error  Print  file  Logical  unit  13 
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f.  Interfaces 


Called  by:  DRIV12 

Calls  to:  FSORT  (FORTRAN  sort  utility) 

WRTERR  (NERR) 

DOITNO  (LUNIN,  LUNOUT,  IDEBUG) 

CHKNUL  (CHKFIE,  LENG) 

D0IT12  (LUNIN,  LUNOUT,  IDEBUG) 

ISSFIN  ( ID1,  ID2,  LUNISS,  IE,  ISSEOF) 


g.  Arguments 

IDEBUG  -  flag  for  debug  print. 

IOK  -  if  set  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Codes  in  SETTPS  are  1,  7,  103. 


2. 4. 3. 2  PROGRAM  DESCRIPTION 


a.  Identification 

Preprocessor  Subroutine  -  SETUIC  (IDEBUG,  IOK) 

Process  Number:  1.2.2 

b.  Function 

This  subroutine  sets  the  ISSUE  in  the  UlC-data  file  for  the  ISSUEs 
that  are  grouped  on  the  basis  of  UIC. 

c.  Input 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  24 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  25 

ISSUE  Definition  file  Logical  unit  14 

d.  Processing 

Sort  ISSUE  file  on  identification  method. 

Sort  UlC-data  file  on  characters  2  through  6  of  UIC  (normally  only  2 
through  4  will  be  significant). 

Set  ISSUE  when  UIC  matches  on  number  of  characters  specified  by  ID1. 
Write  warning  message  if  ISSUE  is  not  blank. 

e.  Output 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  24 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  25 

Error  Print  file  Logical  unit  13 

f.  Interfaces 

Called  by:  OR  I V12 

Calls  to:  WRTERR  (NERR) 

DOITNO  (LUNIN,  LUNOUT,  IDEBUG) 

FSORT  (FORTRAN  sort  utility) 

ISSFIN  (101,  ID2,  LUNISS,  IE,  ISSEOF) 

g.  Arguments 

IDEBUG  -  flag  for  debug  print. 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 
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h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 

Dictionary.  - 

i.  Error  Codes.  The  Error  Codes  in  SETUIC  are  1,  6,  7,  43,  103. 
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2. 4. 3. 3  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Subroutine  -  SETASG  (IDEBUG,  IOK) 
Process  Number:  1.2.3 

b.  Function 


This  subroutine  sets  ISSUE  in  the  UlC-data  file  at  the  three-digit 
level  for  the  ISSUES  that  are  grouped  on  the  basis  of  ASGMT. 

c.  Input 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  24 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  25 

ISSUE  Definition  file  Logical  unit  14 

d.  Processing 

Sort  UlC-data  file  on  ASGMT/LOCCO. 

If  ISSUE  is  blank,  set  ISSUE  when  ASGMT  and  LOCCO  match. 

Sort  UlC-data  file  on  ASGMT/STACCO. 


If  ISSUE  is  blank,  set  ISSUE  when  ASGMT  and  STACCO  match. 
Sort  UlC-data  file  on  ASGMT. 


If  ISSUE  is  blank,  set  ISSUE  when  ASGMT  match. 

If  ISSUE  is  still  blank,  set  ISSUE  when  character  1  of  ASGMT  matches. 
Write  error  message  if  ISSUE  is  not  set  in  all  records. 

e.  Output 


Error  Print  file  Logical  unit  13 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  24 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  25 

f.  Interfaces 

Called  by:  DRIV12 

Calls  to:  WRTERR  (NERR) 

DOITNO  (LUNIN,  LUNOUT,  IDEBUG) 

ISSFIN  ( 101,  102,  LUNISS,  IE,  ISSEOF) 
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g.  Arguments 

IDEBUG  -  flag  for  debug  print. 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  Data  Dictionary. 

i.  Error  Codes.  The  Error  Codes  in  SETASG  are  5,  7. 
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2. 4. 3. 4  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Subroutine  -  AGGUIC  (IDEBUG,  IOK) 

Process  Number:  1.2.4 

b.  Function 

This  subroutine  provides  the  user  with  a  list  of  the  units  that  will 
be  aggregated  into  each  ISSUE  and  the  aggregated  structure  and 
authorized  strengths  from  the  UlC-data  file. 

c.  Input 

UlC-data  (three-digit  level  with  ISSUE  added)  file  Logical  unit  24 

or  25 


d.  Processing 

Sort  the  UlC-data  file  on  three-digit  UIC  within  ISSUE. 

Read  the  UlC-data  file  and  aggregate  the  structure  and  authorized 
strengths  for  each  ISSUE. 

Print  a  list  of  the  three-digit  UICs  that  are  included  in  each  ISSUE. 

e.  Output 

Printed  listing  of  UICs  in  each  ISSUE  and  the  aggregated  ISSUE 
authorized  and  structure  strengths 

f.  Interfaces 

Called  by:  DRIV12 

Calls  to:  APRTCA  (PRIM  utility) 

FSORT  (FORTRAN  sort  utility) 


g.  Arguments 

IDEBUG  -  flag  for  debug  print. 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  AGGUIC. 


i  • 
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2.4.3. 5  PROGRAM  DESCRIPTION 


a.  Identification 

Preprocessor  Subroutine  -  SETMOS  ( IDEBUG,  IOK) 

Process  Number:  1.2.5 

b.  Function 

This  subroutine  sets  the  ISSUE  code  in  the  MOS-data  file 

c.  Input 

UlC-data  (three-digit  with  ISSUE  added)  file  Logical  unit  24  or  25 
MOS-data  (three-digit  UIC  level)  file  Logical  unit  29 

d.  Processing 

Sort  the  UlC-data  file  on  UIC. 

Match  the  MOS-data  file  with  the  UlC-data  file,  matching  on  UIC. 

When  a  match  is  found,  set  the  ISSUE  in  the  MOS-data  file  to  the  ISSUE 
found  in  the  UlC-data  file. 

If  any  records  are  not  matched,  write  an  error  message. 

e.  Output 

Error  Print  file  Logical  unit  13 

MOS-data  (with  ISSUE  added)  file  Logical  unit  30 

f.  Interfaces 

Called  by:  DRIV12 

Calls  to:  CHKNUL  (variable  to  check,  number  of  characters) 

DOITNO  (LUNIN,  LUNOUT,  IDEBUG) 

FSORT  (FORTRAN  utility  subroutine) 

WRTERR  (Nerr) 


g.  Arguments 

IDEBUG  -  flag  for  debug  print. 

IOK  -  If  not  equal  to  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Code  in  SETMOS  is  5. 


2.4. 3.6  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Subroutine  -  CHKNUL  (CHKFIE,  LENG) 

b.  Function 

This  subroutine  checks  the  input  alphanumeric  for  the  presence  of  the 
null  character  (octal  00)  and  replaces  with  a  blank  (octal  40). 

c.  Input 

Subroutine  arguments 

d.  Processing 

Check  each  character  against  octal  00. 

If  a  match  is  found,  reset  character  to  a  blank  (octal  40). 

e.  Output 

Subroutine  argument  modified  -  CHKFIE 

f.  Interfaces 

Called  by:  DRIV12 
SETMOS 

Calls  to:  N/A 

g.  Arguments 

CHKFIE  -  field  to  be  checked 
LENG  -  length  of  CHKFIE 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  CHKNUL. 
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2. 4. 3. 7  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Subroutine  -  D0IT12  (LUNIN,  LUNOUT,  IDEBUG) 

b.  Function 

This  subroutine  puts  an  end  of  file  mark  on  the  output  unit,  rewinds 
both  the  input  and  output  units,  and  resets  the  unit  numbers. 

c.  Input 

Subroutine  arguments 

d.  Processing 

Write  end  of  file  on  ^UNOUT. 

Rewind  LUNIN  and  LUNOUT. 

Set  LUNIN  equal  to  LUNOUT. 

If  LUNIN  was  24,  reset  it  to  25;  if  it  had  been  25,  reset  it  to  24. 

e.  Output 

Subroutine  arguments  modified  -  LUNIN,  LUNOUT 

f.  Interfaces 

Called  by:  SETTPS 
SETUIC 
SETASG 

Calls  to:  N/A 

g.  Arguments 

LUNIN  -  logical  unit  for  input 
LUNOUT  -  logical  unit  for  output 
IOEBUG  -  flag  for  debug  print 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  There  are  no  Error  Codes  in  D0IT12. 


2.4. 3.8  PROGRAM  DESCRIPTION 


a.  Identification 

Preprocessor  Subroutine  -  DOITNO  (LUNIN,  LUNOUT,  IDEBUG) 

b.  Function 

This  subroutine  rewinds  both  the  input  and  output  units  and  resets  the 
unit  numbers.  Similar  to  00 I T 1 2  but  does  not  write  end  of  file. 

c.  Input 

Subroutine  arguments 

d.  Processing 

Rewind  LUNIN  and  LUNOUT. 

Set  LUNIN  equal  to  LUNOUT. 

If  LUNIN  was  24,  reset  it  to  25;  if  it  had  been  25,  reset  it  to  24. 

e.  Output 

Subroutine  arguments  modified  -  LUNIN,  LUNOUT 

f.  Interfaces 

Called  by:  SETTPS 
SETUIC 
SETASG 

Calls  to:  N/A 

g.  Arguments 

LUNIN  -  logical  unit  for  input 
LUNOUT  -  logical  unit  for  output 
IDEBUG  -  flag  for  debug  print 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  DOITNO. 
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2. 4. 3. 9  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  -  ISSFIN  (FIRST,  SECOND,  LUNISS,  IE,  ISSEOF) 

b.  Function 

This  subroutine  will  cause  an  error  message  to  be  written  when  the  end 
of  file  on  the  UlC-data  file  is  reached  before  the  end  of  file  on  the 
ISSUE  file. 

c.  Input 

Subroutine  arguments 

ISSUE  Definition  file  Logical  unit  14 

d.  Processing 

When  EOF  is  encountered  on  UlC-data  file,  and  ISSUE  file  has  unused 
ISSUE  definitions,  an  error  message  is  written  for  each  unused 
definition. 

e.  Output 

Error  Print  file  Logical  unit  13 

Subroutine  arguments  modified  -  IE,  ISSSOF 

f.  Interfaces 

Called  by:  SETTPS 
SETUIC 
SETASG 

Calls  to:  WRTERR  (NERR) 

g .  Arguments 

FIRST  First  identification  method  (ID1)  of  last  ISSUE  record 
processed. 

SECONO  Second  identification  method  (102)  of  last  ISSUE  record 
processed . 

LUNISS  Logical  unit  number  of  the  ISSUE  file. 

IE  Integer  count  of  the  number  of  errors  found  by  ISSFIN. 

ISSEOF  ISSUE  file  end  of  file  flag. 


3  _ 
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h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  ISSFIN  is  7. 


I 


i 

i 


i 
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2.4.4  PROGRAM  DESCRIPTION 

a.  Identification 

Preprocessor  Main  Program  -  DRIV13 
Process  Number:  1.3 

b.  Function 

This  program  calls  the  subroutine  that  aggregates  the  MOS-data  file  to 
ISSUE  level. 

c.  Input  (via  subroutines) 

Parameter  file  Logical  Unit  17 

MOS-data  (three-digit  with  ISSUE  code  added)  file  Logical  Unit  30 

d.  Processing 

Get  day  of  week. 

Get  time  of  day. 

Read  debug  flag. 

Call  AGGMOS. 


Print  ending  messages. 

e.  Output  (via  subroutines) 

MOS-data  (ISSUE  level)  file 
Strengths-by-grade  Print  file 
Strengths-by-MOS  Print  file 

f.  Interfaces 


Logical  Unit  31 
Logical  Unit  85 
Logical  Unit  36 


Called  by:  N/A 

Calls  to:  GETWCT  (ISN,  ISM,  ISS,  LH,  LM,  LS) 

GETDAY  (RUNDAY) 

AGGMOS  ( IOEBUG,  I0K) 

WRTERR  (NERR) 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  DRIVE  13  is  0  (zero). 
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2.4.4. 1  PROGRAM  DESCRIPTION 


a.  Identification 

Preprocessor  Subroutine  -  AGGMOS  (IDEBUG,  IOK) 

Process  Number:  1.3.1 

b.  Function 

This  subroutine  aggregates  the  MOS-data  file  to  ISSUE  level. 

c.  Input 

Parameter  file  Logical  unit  17 

MOS-data  (three-digit  with  ISSUE  added)  file  Logical  unit  30 

d.  Processing 

Get  Parameter  file  data. 

For  each  ISSUE,  aggregate  strengths  over  all  MOS  for  each  grade  and 
write  to  file  85. 

For  each  ISSUE,  aggregate  strengths  over  all  grades  for  each  MOS  and 
write  to  file  86. 

Aggregate  strengths  by  MOS  and  grade  for  each  ISSUE  and  write  to  file 
31. 

e.  Output 

Error  Print  file  Logical  unit  13 

MOS-data  (ISSUE  level)  file  Logical  unit  31 

Strengths-by-grade  Print  file  Logical  unit  35 

Strengths-by-MOS  Print  file  Logical  unit  86 

f.  Interfaces 

Called  by:  0RIV13 
Calls  to:  WRTERR  (NERR) 

g.  Arguments 

IDEBUG  -  flag  for  debug  print. 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Codes  in  AGGMOS  are  30,  32,  40,  70,  71,  98, 
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Figure  2-3.  Program  Unit  Hierarchy  -  Preprocessor 


AGGMOS 


WRTERR 
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2.5  PROGRAM  DESCRIPTION  -  POLICY  PROCESSOR.  Subsection  2.5  contains  a 
description  of  the  five  modules  of  the  Policy  Processor.  In  addition  to 
the  main  programs,  there  are  35  subroutines  associated  with  this  processor. 
Ten  of  these  subroutines  are  numbered  functions;  7  subroutines  are  PRIM 
utilities,  and  18  are  Policy  Processor  utilities.  A  complete  listing  of 
the  programs  discussed  in  subsection  2.5  is  shown  below;  PRIM  utilities  are 
discussed  in  section  2.10. 


Paragraph 

Program 

Process 

2. 5. 1.1 

DRIVE2/1 

2.1 

2.5. 1.2 

EDIPOL 

2.1.0 

2. 5. 1.3 

INSIDE 

Utility 

2. 5. 2.1 

DRIVE2/2-A 

2.2/A 

2. 5. 2. 2 

APP22A 

2.2/A 

2. 5. 2. 3 

GETPAR 

2.2.1 

2. 5. 2. 4 

SRTPOL 

2.2.2 

2. 5. 2. 5 

AGISPO 

2.2.3 

2. 5. 2. 6 

ISMO 

2.2.4,  2.2.5 
and  2.2.6 

2. 5. 3.1 

DRIVE2/2-B 

2. 2/B 

2. 5. 3. 2 

APP22B 

2. 2/B 

2. 5. 4.1 

DRIVE2/2-C 

2.2/C 

2. 5. 4. 2 

APP22C 

2.2/C 

2. 5. 5.1 

DRIVE2/3 

2.3 

2. 5. 5. 2 

APP23 

2.3 

2. 5. 5. 3 

SETBAS 

2.3.0 

2. 5.6.1 

C0NP0L 

Utility 

2. 5. 6. 2 

DOIT 

Utility 

2. 5. 6. 3 

FINDAT 

Utility 

2. 5. 6. 4 

FINVAL 

Utility 

2. 5. 6. 5 

GETBAS 

Utility 

2. 5. 6. 6 

GETJOB 

Utility 

2. 5. 6. 7 

GETPOL 

Utility 

2. 5.6.8 

MAKAGG 

Utility 

2. 5. 6. 9 

MAKIND 

Utility 

2.5.6.10 

MATPOL 

Utility 

2.5.6.11 

NXTISS 

Utility 

Short  description 

Main  program  for  policy  edit 

Policy  edit 

Edit  subroutine 

Main  program  for  Module  A 

of  Apply  Policy 

Apply  Policy  Module  2/A 

Get  parameter  data 

Sort  &  separate  policy  data 

Set  aggregated- ISSUE  policy 

indicators 

Apply  ISSUE/MOS  policies 

Main  program  for  Module  B 
of  Apply  Policy 
Apply  Policy.  Module  2/B 
Main  program  for  Module  C 
of  Apply  Policy 
Apply  Policy  Module  2/C 
Main  program  for  apply 
base  values 
Apply  base  values 
Set  base  values 
Convert  policy  data 
Do  coordination  of  MATPOL 
and  SETPOL 

Find  matching  data  sets 
Find  EOF  on  JAV  file 
Get  next  value  record 
Get  next  MOS-data  record 
Get  next  policy  record 
Make  aggregated  grade 
JAV  record 

Make  individual  grade 
JAV  record 

Match  aggregated-ISSUE 
policies  with  job  ISSUES 
Compute  the  next  unique 
demand  node  name  for  an 
ISSUE 
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2.5.6.12 

SETPOL 

Utility 

Set  policy  indicators  needed 
by  MAKAGG  and  MAKING 

2.5.6.13 

WRTEXT 

Utility 

Write  extra  (unused)  MOS-data 
records 

2.5.6.14 

WRTUNF 

Utility 

Write  unfilled  job  records 

2.5.6.15 

WRTVAL 

Utility 

Write  JAV  records 

2.5.6.16 

ZEROIN 

Utility 

Zero  the  policy  indicators 

2.5.6.17 

ZILCH 

Utility 

Zero  the  output  JAV  variables 

Since  this  processor  was  originally  designed  and  programed  as  one  main 
program  which  sequentially  called  the  three  major  functions,  an  inspection 
of  the  program  code  will  show  that  the  five  main  programs  or  drivers  are 
still  nearly  identical.  The  major  difference  is  the  code  that  has  been 
commented  to  inhibit  processing  the  entire  Policy  Processor  at  one  time. 

If  it  should  be  desired,  the  first  driver  (DRIVE/2-1)  and  main  subroutine 
APP22A,  APP22B,  and  APP22C  could  be  easily  recompiled  to  operate  the  entire 
processor.  The  three  major  functions  of  the  Policy  Processor  are: 

a.  Policy  Edit 

b.  Apply  Policies  -  Apply  the  personnel  policies  to  the  relevant 
MOS-data  file. 

c.  Set  Base  Values  -  Edit  the  Value  file  and  apply  the  values  to  the 
remaining  MOS-data. 

The  second  function.  Apply  Policies,  consists  of  six  subfunctions. 
Several  of  these  could  produce  prodigious  error  messages;  each  assumes  that 
errors  previously  encountered  have  been  corrected.  Therefore,  each  time  a 
different  sort  of  the  data  is  required  in  order  to  continue,  this  module 
stops  to  provide  the  user  with  an  error  correction  opportunity.  If 
corrections  are  made,  the  user  is  required  to  restart  this  processor  with 
the  first  subprocessor.  Policy  Edit;  unless  the  Policy  file  is  very  large 
Policy  Edit  takes  only  a  few  seconds.  Since  Module  A  separates  the  policy 
types,  it  must  then  be  rerun.  The  Apply  Policy  function  consists  of  these 
modules: 

Module  A  -  Separate  the  Policy  file  into  the  four  policy  types 

-  Set  the  aggregate  indicators  for  personnel  policies  that 
apply  to  the  Aggregated-ISSUE-level  (00  level) 

-  Apply  the  personnel  policies  that  reference  specific  MOS  in 
specific  ISSUES  and  apply  aggregated  policies  to  these 
records 

Module  B  -  Apply  the  policies  that  pertain  to  specific  MOS  in  all  ISSUES 

Module  C  -  Apply  the  policies  that  refer  to  all  MOS  in  specific  ISSUEs 
and  apply  aggregated  policies 
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All  three  modules  of  the  Apply  Policies  function  require  use  of 
Parameter  file  data.  Therefore,  GETPAR,  Process  2.2.1,  is  repeated  in  each 
of  these  modules.  Each  execution  of  GETPAR  requires  less  than  1  second.  A 
further  complication  in  the  understanding  of  these  modules  is  the  operation 
of  the  subroutines  ISMO  and  FINDAT.  ISMO  controls  the  application  of  both 
ISSUE  and  MOS  policies  including  the  application  of  combined  ISSUE  and  MOS 
policies.  FINDAT  finds  the  point  in  the  input  job  file  (MOS-data)  where 
the  next  policy  should  be  applied.  Both  ISMO  and  FINDAT  are  controlled  by 
the  calling  subroutine  (APP22A,  APP22B,  or  APP22C)  by  the  value  of  the 
variable  named  IFLAG. 

Prior  to  execution  of  Module  A,  the  runstream  should  cause  a  sort  of  the 
input  MOS-data  file  on  the  maximum  number  of  characters  (NCCHAR  in  the 
Parameter  file)  of  MOS  within  the  ISSUE  code.  As  Module  A  matches  the  Com¬ 
bined  ISSUE  and  MOS  Policy  file  against  the  MOS-data  file,  all  MOS  records 
not  matched  by  a  policy  are  written  to  the  extra  (unmatched)  MOS-data  file; 
matched  records  are  written  to  the  Job  Assignment  Value  file  with  the 
appropriate  data  transformations.  More  specific  information  on  the  trans¬ 
formations  may  be  found  in  Appendix  C,  User-defined  files,  and  in  the  User 
Manual.  The  extra  MOS-data  is  sorted  on  MOS  prior  to  execution  of  Module 
B.  The  same  general  logic  is  followed  for  both  Modules  B  and  C;  Module  B 
applies  the  MOS  policies,  and  Module  C  applies  the  ISSUE  policies. 

The  third  and  final  function  of  the  Policy  Processor  is  to  apply  the 
value  data  to  the  job  data  not  previously  matched  by  a  specific  policy. 

The  same  general  logic  is  used  as-  was  used  in  the  Apply  Policies  function, 
except  that  all  job  data  not  matched  in  this  step  will  be  written  to  the 
Unfilled  Job  file.  The  data  transformations  are  described  in  Appendix  C, 
User-defined  files. 

Demand  node  names  are  written  to  the  JAV  file  and  extra  job-data  file  by 
Module  A,  Combined  ISSUE,  and  MOS  policy  application;  the  extra  MOS-data 
file  has  demand  node  names  that  are  made  up  of  the  four-character  ISSUE 
code  followed  by  two  alphabetic  characters.  A  unique  set  is  used  for  each 
MOS.  Since  all  characters  from  A  through  Z  are  used,  this  aspect  of  PRIM 
allows  for  a  maximum  of  676  MOS  in  each  ISSUE.  The  last  characters  will  be 
set  to  blank.  During  the  next  pass  for  MOS  policies,  an  additional 
character  is  added  in  the  seventh  position.  The  eighth  position  is  added 
during  the  pass  for  ISSUE  policies.  Finally,  the  eighth  character  is 
changed  from  alphabetic  to  numeric  during  the  application  of  the  Value 
file.  Demand  node  names  ending  with  a  numeric  one  (1)  in  the  eighth 
position  specify  the  minimum  fill  levels  as  both  the  minimum  and  maximum 
levels.  The  record  specifying  the  desired  fill  from  the  minimum  to  the 
maximum  possible  is  designated  by  a  two  (2)  in  the  last  position  of  the 
name.  These  manipulations  of  the  job  names  are  necessitated  by  the 
requirement  that  all  demand  node  names  must  be  unique.  After  job 
assignments  are  made  by  the  Assignment  Processor  and  the  Substitute 
Assignment  Processor,  the  Readiness  Processor  will  aggregate  these 
individual  records  back  up  to  ISSUE-level. 
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A  set  of  figures  is  provided  to  assist  the  reader  in  better  under¬ 
standing  the  relationship  of  the  main  programs  and  subroutines  in  the 
Policy  Processor.  Figure  2-5  shows  the  information  flow;  Figure  2-6  shows 
the  relationship  of  the  routines  within  the  Policy  Processor;  Figure  2-6, 
along  with  Figure  2-7,  the  subroutine  cross-reference  allows  the  reader  to 
see  which  routines  are  called  by  routines  other  than  the  main  programs. 
These  figures  are  at  the  end  of  section  2.5. 
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2. 5.1.1  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Main  Program  Number  1  -  DRIVE2/1 
Process  Number:  2.1 

b.  Function 

This  program  controls  the  processing  sequence  of  the  Policy  Processor. 
This  particular  version  calls  the  Policy  file  edit  subroutine.  By 
removing  comments,  it  could  be  used  to  call  all  the  Policy  Processor 
functions. 

c.  Input  (via  the  main  subroutine  EDIPOL) 

ISSUE  Definition  file  Logical  unit  14 

Parameter  file  Logical  unit  17 

Policy  file  Logical  unit  91 

d.  Processing 

Get  and  print  the  time  and  date. 

Initialize  the  Error  Print  file. 

Call  the  subroutine  which  controls  the  editing  of  the  Policy  file. 
Print  the  amount  of  time  used  and  number  of  errors  and  warnings. 

e.  Output  (via  the  main  subroutine) 

Edited  Policy  file  Logical  unit  92 
Error  Print  file  Logical  unit  13 

f.  Interfaces 
Called  by:  N/A 

Calls  to:  APRTCA  (PRIM  utility) 

GETWCT  (ISN,  ISM,  ISS,  LH,  LM,  LS) 

GETDAY  (RUNDAY) 

WRTERR  (0) 

EDIPOL 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  DRIVE2/1  is  0  (zero). 
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2. 5. 1.2  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Subroutine  -  E0IP0L 
Process  Number:  2.1.0 

b.  Function 

This  subroutine  edits  the  Policy  file  for  valid  values  and  compares 
the  ISSUE  with  ISSUES  from  the  ISSUE  file  for  acceptability. 


c.  Input 

ISSUE  Definition  file 
Parameter  file 
Policy  file 

d.  Processing 


Logical  unit  14 
Logical  unit  17 
Logical  unit  91 


Read  ISSUES  from  the  ISSUE  Definition  file  and  save  the  codes. 

Read  the  Parameter  file. 

Read  a  policy  record. 

Check  for  validity  of  ISSUE,  maximum  fill  level,  minimum  fill  level, 
low  grade,  high  grade  value,  aggregation  value  -  if  all  are  valid, 
write  the  edited  record  and  return  to  read  the  next  policy  record. 

If  invalid,  write  appropriate  error  messages  and  read  next  policy 
record  without  writing  the  policy  record. 

e.  Output 

Edited  Policy  file  Logical  unit  92 
Error  Print  file  Logical  unit  13 

f.  Interfaces 

Called  by:  DRIVE2/1 

Calls  to:  GETPAR  (I0K) 

WRTERR  (NERR) 

ICHINT  (alpha,  begin,  length,  return  flag) 

RCHFLT  (alpha,  begin,  length,  return  flag) 

INSIDE 

g.  Arguments.  N/A 


•  • 
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h.  Tables  and  Iteas.  Please  refer  to  Appendix  A  for  Data  Dictionary. 

1.  Error  Codes.  Error  Codes  in  EDIPOL  are  10,  11,  12,  13,  14,  15,  16, 
17,  18,  19,  20,  21,  22,  27,  30,  35,  36,  37,  39,  46,  98,  99,  113. 


2. 5. 1.3  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Utility  Subroutine  -  INSIDE 
Process  Number:  2.1.1 

b.  Function 

This  subroutine  tests  the  high  and  low  subscripts  of  grade  levels  and 
the  maximum  and  minimum  fill  levels  for  acceptability. 

c.  Input.  N/A;  this  subroutine  is  internal  to  subroutine  EDIPOL. 

d.  Processing 

Test  grade  for  acceptability. 

If  grade  is  not  acceptable,  write  error  message  and  return  to  calling 
routine. 

Test  maximum  and  minimum  fill  levels  for  acceptability. 

If  fill  levels  are  not  acceptable,  then  write  error  message  and  return 
to  calling  routine. 

e.  Output.  N/A 

f.  Interfaces 
Called  by:  EDIPOL 
Calls  to:  N/A 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  INSIDE. 
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Logical  unit  17 
Logical  unit  92 
Logical  unit  31 


2. 5. 2.1  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Main  Program  Number  2  -  DRIVE2/2-A 
Process  Number:  2.2 

b.  Function 

This  program  controls  the  processing  sequence  of  the  Policy  Processor. 
This  version  calls  the  first  four  subfunctions  of  the  Apply  Policy 
function.  This  includes  get  Parameter  file  data,  separate  Policy  file 
data,  compute  aggregated  indicators,  and  apply  combined  ISSUE  and  MOS 
policies. 

c.  Input  (via  subroutines) 

Parameter  file 
Edited  Policy  file 
MOS-data  (ISSUE  level)  file 

d.  Processing 

Get  and  print  the  time  and  date. 

Initialize  the  Error  Print  file. 

Call  the  subroutine  which  controls  the  Apply  Policy  function, 
subfunctions  1  through  4  (APP22A). 

Print  amount  of  time  used  and  number  of  errors  and  warnings. 

e.  Output  (via  subroutines) 

Aggregated-ISSUE  Policy  file 
ISSUE  Policy  file 
MOS  Policy  file 

Combined  ISSUE  &  MOS  Policy  file 
Aggregated-ISSUE  Indicator  file 
Error  Print  file 

Combined  ISSUE  and  MOS  Extra  Job  file 
Job  Assignment  Value  file 

f.  Interfaces 


Logical 

unit 

32 

Logical 

unit 

33 

Logical 

unit 

34 

Logical 

unit 

35 

Logical 

unit 

90 

Logical 

unit 

13 

Logical 

unit 

36 

Logical 

unit 

39 

Called  by: 
Calls  to: 


N/A 

APRTCA 

APP22A 

GETDAY 

GETWCT 

WRTERR 

(PRIM  utility) 
(I0K) 

(RUNDAY) 

(ISH,  ISM,  ISS,  LH 
(0) 
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2. 5. 2. 2  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  APP22A  (IOK) 

Process  Number:  2.2A 

b.  Function 

This  subroutine  controls  the  sequence  of  the  subfunctions  included  in 
the  Apply  Policy  function.  This  version  includes  get  the  parameter 
data,  separate  the  policy  data,  compute  the  aggregated-ISSUE 
indicators,  and  apply  the  combined  ISSUE  and  MOS  policies.  File 
number  definition,  REWIND,  and  DEFINE  FILE  operations  are  performed 
here. 

c.  Input  (via  subroutines) 

Parameter  file  Logical  unit  17 

MOS-data  (ISSUE  level)  file  Logical  unit  31 

Edited  Policy  file  Logical  unit  92 

d.  Processing 

Get  beginning  time. 

Get  Parameter  file  data. 


Separate  Policy  file  data  by  policy  type. 

Set  aggregated-ISSUE  policy  indicators. 

Sort  the  combined  ISSUE  and  MOS  Policy  file. 


Apply  combined  ISSUE  and  MOS  policies  by  calling  ISMO  with  IFLAG=2. 


Get  and  print  amount  of  time  used  and  numbers  of  records  processed. 

e.  Output  (via  subroutines) 


Error  Print  file 
Aggregated-ISSUE  Policy  file 
ISSUE  Policy  file 
MOS  Policy  file 

Combined  ISSUE  and  MOS  Policy  file 
Aggregated-ISSUE  Indicator  file 
Combined  ISSUE  and  MOS  Extra  Job  File 


Logical  unit  13 
Logical  unit  32 
Logical  unit  33 
Logical  unit  34 
Logical  unit  35 
Logical  unit  90 
Logical  unit  36 


f.  Interfaces 


Called  by:  DRIVE2/2-A 

Calls  to:  GETDAY  (RUNDAY) 

GETPAR  ( IOK) 

SRTPOL  (IOK) 

GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 

AGISPO  (IOK) 

FSORT  (FORTRAN  sort  utility) 

ISMO  (IOK) 

g.  Arguments 

IOK  -  If  set  to  value  other  than  zero,  program  cannot  continue 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  APP22A  is  0  (zero). 
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2. 5.2.3  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Subroutine  -  GETPAR  (IOK) 

Process  Number:  2.2.1 

b.  Function 

This  subroutine  gets  the  as-of-date,  grade  codes  and  location,  and 
authorized  or  required  variables  from  the  Parameter  file. 


c.  Input 
Parameter  file 

d.  Processing 


Logical  unit  17 


Get  the  as-of-date  from  the  Parameter  file. 

Get  the  number  of  grades  from  the  Parameter  file,  NGRADE. 

Get  the  integer  locations  and  alphanumeric  codes  for  each  grade. 

Get  the  number  of  characters  of  the  MOS,  NCCHAR. 

Determine  whether  authorized  or  required  fill  levels  are  to  be  used  in 
this  run,  TYPSTR. 


e.  Output 

Error  Print  file 


f.  Interfaces 


Logical  unit  13 


Called  by:  APP22A,  APP22B,  APP22C 

Calls  to:  ICHINT  (alpha,  begin,  end,  return  flag) 

WRTERR  (NERR) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Err;r  Codes  in  GETPAR  are  30,  37,  39,  40,  41,  98, 
99. 
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2. 5. 2. 4  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  SRTPOL  (IOK) 
Process  Number:  2.2.2 

b.  Function 


This  subroutine  sorts  the  Policy  file  into  Aggregated-ISSUE,  ISSUE 
only,  MOS  only,  or  combined  ISSUE  and  MOS  policies  and  rewrites  the 
Policy  file  into  four  separate  files. 

c.  Input 

Edited  Policy  file  Logical  unit  92 


d.  Processing 

Sort  Policy  file  into  ISSUE  or  MOS  policies  (characters  1-5). 


Write  specific  ISSUE  policies  to  logical  unit  33. 
Write  specific  MOS  policies  to  logical  unit  34. 


Write  aggregated-ISSUE  policies  to  logical  unit  32. 

Write  combined  ISSUE  and  MOS  policies  to  logical  unit  35. 


e.  Output 

Error  Print  file 
Aggregated-ISSUE  Policy  file 
ISSUE  Policy  file 
MOS  Policy  file 

Combined  ISSUE  and  MOS  Policy  file 


Logical  unit  13 
Logical  unit  32 
Logical  unit  33 
Logical  unit  34 
Logical  unit  35 


f.  Interfaces 


Called  by:  APP22A 

Calls  to:  FSORT  (FORTRAN  sort  utility) 
WRTERR  (NERR) 


g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Codes  in  SRTPOL  are  42,  99. 


2. 5. 2. 5.  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  AGISPO  (IOK) 

Process  Number  2.2.3 

b.  Function 

This  subroutine  reads  the  policies  that  are  stated  in  terms  of  the 
aggregated-ISSUE,  sets  the  indicators,  and  writes  all  of  the 
indicators  to  a  file  to  save  for  later  use. 

c.  Input 

Aggregated-ISSUE  Policy  file  .  Logical  unit  32 

d.  Processing 

Read  the  Aggregated-ISSUE  policies. 

Set  indicators  necessary  for  computing  minimum  and  maximums. 

Write  the  indicators  to  a  file  to  save  for  later  use. 

e.  Output 

Error  Print  file  Logical  Unit  13 

Aggregated-ISSUE  Indicator  file  Logical  unit  90 

f.  Interfaces 

Called  by:  APP22A 

Calls  to:  CONPOL  (NEWPOL) 

GETPOL  (IOK) 

SETPOL  (IOK) 

WRTERR  (NERR) 

ZEROIN 


g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Codes  in  AGISPO  are  98,  99. 


2.5. 2. 6  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  ISMO  (IOK) 

Process  Number:  2.2.4,  IFLAG=2,  combined  ISSUE  and  MOS  policies 

2.2.5,  IFLAG=3,  MOS  policies 

2.2.6,  IFLAG=1,  ISSUE  policies 


b.  Function 

This  subroutine  controls  the  setting  of  policies  that  are  stated  in 
terms  of  the  ISSUE  only,  MOS  only,  or  both  the  ISSUE  and  MOS.  Records 
that  do  not  match  will  be  written  to  the  "extra"  file. 

c.  Input  (via  subroutines) 

Combined  ISSUE  and  MOS  Policy  file 
MOS  Policy  file 
ISSUE  Policy  file 
MOS-data  (ISSUE  level)  file 
Combined  ISSUE  and  MOS  Extra  Job  File 
MOS  Extra  Job  file 

d.  Processing 

Get  the  next  policy  for  FINDAT  -  after  this,  SETPOL  or  FINDAT  will 
have  read  one  record  beyond  the  policy  record  being  processed. 

Find  the  next  matching  set  of  policy  and  job  data. 

On  return  from  FINDAT,  if  all  flags  =  0,  set  and  write  the  values: 

Set  the  aggregated  grades  and  write  a  JAV  record. 

Set  any  leftover  individual  grades  which  have  a  policy  and  write  a 
JAV  record. 

If  all  policies  have  been  used  ( IEOF^O) ,  copy  the  rest  of  the  MOS-data 
to  the  extra  file  (setting  L ISSUE  and  LMOS  to  all  "Z"  forces,  FINDAT  to 
do  the  copy). 

e.  Output  (via  subroutines) 

Combined  ISSUE  and  MOS  Extra  Job  file  Logical  unit  36  (process  2.2.4) 

MOS  Extra  Job  file  Logical  unit  37  (process  2.2.5) 

ISSUE  Extra  Job  file  Logical  unit  38  (process  2.2.6) 

Error  Print  file  Logical  unit  13 


Logical 

unit 

35 

Logical 

unit 

34 

Logical 

unit 

33 

Logical 

unit 

31 

Logical 

unit 

36 

Logical 

unit 

37 

(process  2.2.4) 
(process  2.2.5) 
(process  2.2.6) 
(process  2.2.4) 
(process  2.2.5) 
(process  2.2.6) 
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2. 5. 3.1  PROGRAM  DESCRIPTION 


a.  Identification 


Policy  Processor  Main  Program  Number  3  -  DRIVE2/2-B 
Process  Number:  2.2/B 

b.  Function 


This  program  controls  the  processing  sequence  of  the  Policy  Processor. 
This  version  applies  the  policies  that  refer  to  specific  MOS  across 
all  ISSUES. 


c.  Input  (via  subroutines) 


Parameter  file 
MOS  Policy  file 

Combined  ISSUE  and  MOS  Extra  Job  file 
Job  Assignment  Value  file 


Logical  unit  17 
Logical  unit  34 
Logical  unit  36 
Logical  unit  39 


d.  Processing 


Get  and  print  the  time  and  date. 


Initialize  the  Error  Print  file. 


Call  the  subroutine  which  controls  the  Apply  Policy  function, 
subfunction  5. 


Print  amount  of  time  used  and  number  of  errors  and  warnings. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

MOS  Extra  Job  file  Logical  unit  37 

Job  Assignment  Value  file  Logical  unit  40 

f.  Interfaces 

Called  by:  N/A 

Calls  to:  APRTCA  (PRIM  utility) 

APP22B  ( IOK) 

GETDAY  (RUNDAY) 

GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 

WRTERR  (0) 


g.  Arguments.  N/A 


h.  Tables  and  Itens.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  DRIVE2/2-B  is  0  (zero). 


2. 5. 3. 2  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  APP22B  ( IOK ) 

Process  Number:  2.2/B 

b.  Function 

This  subroutine  controls  the  sequence  of  the  subfunctions  included  in 
the  Apply  Policy  function.  This  version  includes  get  the  parameter 
data  and  apply  the  MOS  policies.  File  definitions  and  operations  such 
as  REWIND  are  performed  here. 

c.  Input  (via  subroutines) 

Parameter  file  Logical  unit  17 

MOS  Policy  file  Logical  unit  34 

Combined  ISSUE  and  MOS  Extra  Job  file  Logical  unit  36 

Job  Assignment  Value  file  Logical  unit  39 

d.  Processing 

Get  beginning  time. 

Get  Parameter  file  data. 

Sort  the  Policy  file. 

Copy  the  input  Job  Assignment  Value  file  to  the  end  of  file. 

Apply  MOS  policies  by  calling  ISMO  with  IFLAG=3. 

Get  and  print  amount  of  time  used  and  number  of  records  processed. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

MOS  Extra  Job  file  Logical  unit  37 

Job  Assignment  Value  file  Logical  unit  40 

f.  Interfaces 

Called  by:  DRIVE2/2-B 

Calls  to:  GETDAY  (RUNDAY) 

GETPAR  (IOK) 

GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 

FINVAL  (LUVIN,  LUVOUT,  IOK) 

FSORT  (FORTRAN  sort  utility) 

ISMO  (IOK) 


g.  Arguments 

I OK  -  If  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  APP22B  is  0  (zero). 


2. 5.4.1  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Main  Program  Number  4  -  DRIVE2/2-C 
Process  Number:  2.2/C 

b.  Function 

This  program  controls  the  processing  sequence  of  the  Policy  Processor. 
This  version  applies  the  policies  that  refer  to  all  MOS  in  specific 
ISSUES. 

c.  Input  (via  subroutines) 

Parameter  file 
ISSUE  Policy  file 
MOS  Extra  Job  file 
Job  Assignment  Value  file 

d.  Processing 

Get  and  print  the  time  and  date. 

Initialize  the  Error  Print  file. 

Call  the  subroutine  which  controls  the  Apply  Policy  function, 
subfunction  6. 

Print  amount  of  time  used  and  number  of  errors  and  warnings. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

ISSUE  Extra  Job  file  Logical  unit  38 

Job  Assignment  Value  file  Logical  unit  39 

f.  Interfaces 

Called  by:  N/A 

Calls  to:  APRTCA  (PRIM  utility) 

APP22C  ( IOK) 

GETOAY  (RUNDAY) 

GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 

WRTERR  (0) 


Logical  unit  17 
Logical  unit  33 
Logical  unit  37 
Logical  unit  40 


g.  Arguments.  N/A 
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Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

Error  Codes.  The  Error  Code  in  DRIVE2/2-C  is  0  (zero). 
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2. 5. 4.2  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Subroutine  -  APP22C  (IOK) 

Process  Number:  2.2/C 

b.  Function 

This  subroutine  controls  the  sequence  of  the  subfunctions  included  in 
the  Apply  Policy  function.  This  version  includes  get  the  parameter 
data  and  apply  the  ISSUE  policies.  File  definitions  and  operations 
such  as  REWIND  are  performed  here. 


c.  Input  (via  subroutines) 

Parameter  file 

ISSUE  Policy  file 

MOS  Extra  Job  file 

Job  Assignment  Value  file 


Logical  unit  17 
Logical  unit  33 
Logical  unit  37 
Logical  unit  40 


d.  Processing 

Get  the  beginning  time. 

Get  the  Parameter  file  data. 

Sort  the  Policy  file. 

Copy  the  input  Job  Assignment  Value  file  to  the  end  of  file. 

Apply  the  ISSUE  policies  by  calling  ISMO  with  IFLAG=1. 

Get  and  print  the  amount  of  time  used  and  number  of  records  processed 


Logical  unit  13 
Logical  unit  38 
Logical  unit  39 


e.  Output  (via  subroutines) 

Error  Print  file 

ISSUE  Extra  Job  file 

Job  Assignment  Value  file 

f.  Interfaces 

Called  by:  DRIVE2/2-C 


Calls  to:  GETDAY  (RUNDAY) 

GETPAR  (IOK) 

GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 
FINVAL  (LUVIN,  LUVOUT,  IOK) 

FSORT  (FORTRAN  sort  utility) 

ISMO  (IOK) 
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g.  Arguments 

IOK  -  If  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  APP22C. 
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2. 5. 5.1  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Main  Program  Number  5  -  DRIVE2/3 
Process  Number:  2.3 


b.  Function 


This  program  controls  the  processing  sequence  of  the  Policy  Processor. 
This  version  applies  the  Value  file  to  the  job  records  which  had  not 
had  a  specific  policy  applied. 


c.  Input  (via  subroutines) 

Parameter  file 
Value  file 

ISSUE  Extra  Job  Data  file 
Job  Assignment  Value  file 

d.  Processing 


Logical  unit  17 
Logical  unit  19 
Logical  unit  38 
Logical  unit  39 


Get  and  print  the  time  and  date. 
Initialize  the  Error  Print  file. 


Call  the  subroutine  which  performs  the  Set  Base 


Value  function. 


Print  amount  of  time  used  and  number  of  errors  and  warnings. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

Job  Assignment  Value  file  Logical  unit  40 

Unfilled  Jobs  file  Logical  unit  50 

f.  Interfaces 

Called  by:  N/A 

Calls  to:  APRTCA  (PRIM  utility) 

APP23  ( IOK) 

GETDAY  (RUNDAY) 

GFTWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 

WRTERR  (0) 


g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Code  in  DRIVE2/3  is  0  (zero). 


2. 5. 5. 2  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  APP23  (IOK) 
Process  Number:  2.3 


b.  Function 


This  subroutine  applies  the  Value  file  to  job  records  not  matched  by  a 
specific  policy. 

c.  Input  (via  subroutines) 


Parameter  file 

Value  file 

ISSUE  Extra  Job  file 

Job  Assignment  Value  file 

d.  Processing 

Get  the  beginning  time. 


Logical  unit  17 
Logical  unit  19 
Logical  unit  38 
Logical  unit  39 


Apply  the  base  values  to  the  MOS  data. 


Get  and  print  amount  of  time  used  and  number  of  records  processed. 


e.  Output  (via  subroutines) 


Error  Print  file 

Job  Assignment  Value  file 

Unfilled  Jobs  (from  Policy  Processor)  file 


Logical  unit  13 
Logical  unit  40 
Logical  unit  50 


f.  Interfaces 


Called  by:  DRIVE2/2-8 

Calls  to:  GETDAY  (RUNDAY) 

GETPAR  (IOK) 

GETWCT  (ISH,  ISM,  ISS,  LH,  LM,  LS) 
FINVAL  (LUVIN,  LUVOUT,  IOK) 

FSORT  (FORTRAN  sort  utility) 

SETBAS  (IOK) 


g.  Arguments 

IOK  -  If  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  APP23. 


2. 5. 5. 3  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Subroutine  -  SETBAS  (IOK) 

Process  Number:  2.3.0 

b.  Function 

This  subroutine  computes  the  minimum  and  maximum  values  for  the 
records  that  are  set  using  the  input  Value  file. 

The  Value  file  contains  a  minimum  percentage  to  which  all  MOS  within 
an  ISSUE  should  be  filled  and  an  associated  value.  Only  those  records 
which  had  not  previously  had  a  specific  policy  applied  are  considered. 
The  first  record  written  by  SETBAS  for  each  input  record  contains  the 
number  obtained  by  multiplying  the  minimum  percentage  times  the 
strength  of  both  the  minimum  and  maximum  values.  The  second  record 
will  contain  zero  as  the  minimum  number  and  a  number  which  represents 
the  number  of  people  needed  to  reach  the  maximum  fill  level.  This 
number  is  the  maximum  percentage  times  the  strength  minus  the  maximum 
number  from  record  1.  The  maximum  percentage  may  be  greater  than  100 
percent.  The  maximum  percentage  must  be  zero  or  larger  than  the 
minimum  percentage.  More  descriptive  information  on  the  Value  File 
may  be  found  in  Appendix  C,  User  Files. 

c.  Input  (via  subroutines) 

Base  Value  file 
ISSUE  Extra  Job  file 
Job  Assignment  Value  file 

d.  Processing 

Copy  the  input  JAV  file  to  end  of  file. 

Get  the  Value  record  (also  called  base  values). 

If  this  is  the  first  pass  through  this  subroutine  or  if  a  match  was 
found  on  the  ISSUE,  and  the  job  record  was  used,  get  the  next  job 
record. 

If  the  Value  ISSUE  =  Job  ISSUE,  write  JAV  records. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

Job  Assignment  Value  file  Logical  unit  40 

Unfilled  Jobs  (from  Policy  Processor)  file  Logical  unit  50 


Logical  Unit  19 
Logical  unit  38 
Logical  unit  39 


2.5. 6.1  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Utility  Subroutine  -  CONPOL  (POL) 

b.  Function 

This  subroutine  converts  the  policy  stored  in  the  argument  (to  this 
subroutine)  into  the  policy  variables  for  use  by  subroutine  SETPOL. 
Either  SAVPOL  or  NEWPOL  could  be  used  as  the  argument. 

c.  Input 

COMMON  variables 

d.  Processing 

Convert  policy  data  into  usable  values  for  SETPOL— ISSUE,  MOS,  LOGRAD, 
HIGRAD,  AGG,  PERMIN,  PERMAX,  and  VALUE. 

e.  Output 
COMMON  variables 

f.  Interfaces 

Called  by:  SETPOL 
AGISPO 

Calls  to:  ICHINT  (alpha,  begin,  length,  return  flag) 

RCHFLT  (alpha,  begin,  length,  return  flag) 

g.  Arguments 

POL  -  Policy  to  be  converted  into  policy  variables  usable  by 
subroutine  SETPOL.  Either  SAVPOL  or  NEWPOL  could  be  used. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  CONPOL. 
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2. 5.6.2  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  DOIT  (IOK) 

b.  Function 

This  subroutine  makes  sure  that  the  aggregated-ISSUE  policy  has  been 
looked  for  and  that  subroutine  SETPOL  has  been  called. 

c.  Input 

COMMON  variables 

d.  Processing 

If  have  not  obtained  aggregated-ISSUE  policy,  get  it  by  calling 
MATPOL. 

If  have  not  called  SETPOL,  then  call  SETPOL. 

Reset  flags  to  keep  from  repeating  sequence  when  neither  ISSUE  nor  MOS 
have  changed. 

e.  Output 
COMMON  variables 

f.  Interfaces 

Called  by:  FINDAT 

Calls  to:  ZEROIN 
ZILCH 

SETPOL  (IOK) 

MATPOL  (IOK) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  There  are  no  Error  Codes  in  DOIT. 
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2. 5. 6.3  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  FINDAT  (IOK,  IFLAG) 

b.  Function 

This  subroutine  finds  the  correct  job  data  for  the  policy  in  memory. 

c.  Input  (via  subroutines) 

MOS-data  (ISSUE  level)  file  Logical  unit  31 

Combined  ISSUE  and  MOS  Extra  Job  file  Logical  unit  36 

MOS  Extra  Job  file  Logical  unit  37 

d.  Processing 

ISSUE  check  (when  IFLAG  =  1  or  2): 

If  job  ISSUE  is  greater  than  policy  ISSUE,  check  saved  policy. 

If  job  ISSUE  matches  the  saved  policy,  update  the  policy  variables 
by  calling  CONPOL,  and  when  IFLAG  =  2,  check  MOS.  When  IFLAG  =  1, 
return  to  write  the  JAV  record. 

If  job  ISSUE  is  greater  than  saved  policy,  get  next  policy. 

If  there  is  not  a  specific  policy  for  the  job  ISSUE  and  if  this  is 
an  ISSUE  only  search,  write  the  job  data  to  the  extra  file. 

MOS  check  (when  IFLAG  =  2  or  3): 

If  the  job  MOS  is  greater  than  the  policy  MOS,  check  the  saved 
policy. 

If  the  job  MOS  is  greater  than  the  saved  policy,  get  the  next 
policy. 

If  the  job  MOS  matches  the  new  policy,  update  the  policy  variables 
by  calling  CONPOL  and  return  to  write  the  JAV  record. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

Combined  ISSUE  and  MOS  Extra  Job  file  Logical  unit  36 

MOS  Extra  Job  file  Logical  unit  37 

ISSUE  Extra  Job  file  Logical  unit  38 
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Interfaces 

Called  by:  ISMO 

Calls  to:  GETJOB  (IOK) 

CONPOL  (NEWPOL) 

GETPOL  (IOK) 

OOIT  (IOK) 

ICOMP2  (first  alpha,  beginning  character,  second  alpha, 
beginning  character,  number  characters) 

WRTEXT  (IOK) 

MATPOL  (IOK) 


g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

I FLAG  =  1  match  on  ISSUE 

=  2  match  on  ISSUE  and  MOS 
a  3  match  on  MOS  only 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  FINDAT. 
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2. 5. 6. 4  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  FINVAL  (LUVIN,  LUVOUT,  IOK) 

b.  Function 

This  subroutine  finds  the  correct  place  on  the  Job  Assignment  Value 
file  for  this  subprocessor  to  begin  adding  new  records. 

c.  Input  (by  calling  GETVAL) 

Job  Assignment  Value  file  Logical  unit  39  or  40 

(written  by  previous  subprocessor) 

d.  Processing 

Copy  the  input  Job  Assignment  Value  file  to  the  output  Job  Assignment 
Value  file. 

Set  the  logical  unit  number  for  writing  new  Job  Assignment  Value 
records. 

e.  Output  (by  calling  WRTVAL) 

Job  Assignment  Value  file  Logical  unit  39  or  40 

f.  Interfaces 

Called  by:  APP22B,  APP22C,  and  APP23 

Calls  to:  GETVAL  (IOK) 

WRTVAL  (IOK) 


g.  Arguments 

LUVIN  -  logical  unit  number  for  reading  JAV  records 

LUVOUT  -  logical  unit  number  for  writing  JAV  records 

IOK  -  if  this  value  is  not  zero,  the  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 

Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  FINVAL. 
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2. 5. 6. 5  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  GETBAS  (IOK) 

b.  Function 

This  subroutine  reads  the  value  records. 

c.  Input 

Value  file  Logical  unit  19 

d.  Processing 

Read  the  Value  file. 

Check  the  format  of  the  value  record. 

If  the  format  is  acceptable,  convert  the  value  record  to  integers  or 
real  numbers. 

e.  Output 

Error  Print  file  Logical  unit  13 

f.  Interfaces 
Called  by:  SETBAS 

Calls  to:  ICHINT  (alpha,  begin,  length,  return  flag) 

RCHFLT  (alpha,  begin,  length,  return  flag) 

WRTERR  (NERR) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Codes  in  GETBAS  are  23,  24,  25,  26,  61,  62, 
99. 
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2. 5. 6. 6  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  GETJOB(IOK) 

b.  Function 

This  subroutine  reads  all  of  the  job  records. 

c.  Input 

MOS-data  (ISSUE  level)  file  Logical  unit  31 

Combined  ISSUE  and  MOS  Extra  Job  file  Logical  unit  36 

MOS  Extra  Job  file  Logical  unit  37 

ISSUE  Extra  Job  file  Logical  unit  38 

d.  Processing 

Read  the  next  job  data  record  from  the  file  specified  by  LUNJOB. 

If  the  ISSUE  has  changed,  a  new  set  of  DEMAN  names  should  be  started; 
set  the  character  flags. 

Set  character  flags  based  on  the  present  demand  node  name. 

If  end-of-file  has  been  reached,  set  the  end-of-file  flag  (J EOF). 

e.  Output 

Error  Print  file  Logical  unit  13 

f.  Interfaces 

Called  by:  FINDAT 
SETBAS 

Calls  to:  WRTERR  (NERR) 

NXTISS 


g.  Arguments 

I OK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Codes  in  GETJOB  are  98,  99,  125. 


2-68 


CAA-D-84-2 


2. 5. 6. 7  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  GETPOL  (IOK,  IEOF) 

b.  Function 

This  subroutine  reads  the  policy  data  from  any  of  the  four  files 
written  by  SRTPOL. 

c.  Input 

Aggregated-ISSUE  Policy  File  Logical  unit  32 

ISSUE  Policy  file  Logical  unit  33 

MOS  Policy  file  Logical  unit  34 

Combined  ISSUE  and  MOS  Policy  file  Logical  unit  35 

d.  Processing 

Read  the  next  record  of  the  policy  file  specified  by  the  va  \e  LUNPOL. 
If  end-of-file  has  bee-i  reached,  set  the  flag  (IEOF). 

e.  Output 

Error  Print  file  Logical  unit  13 

f.  Interfaces 

Called  by:  AGISPO 
SETPOL 
ISMO 
FINDAT 

Calls  to:  WRTERR  (NERR) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

IEOF  -  set  to  1  if  end-of-file  found  while  reading  file. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  for  GETPOL  is  99. 
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2. 5. 6. 8  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  MAKAGG  (IOK) 

b.  Function 

This  subroutine  computes  the  values  for  maximum,  minimum,  and 
assignment  values  for  the  aggregate  and  for  the  grades  included  in 
that  aggregate. 

c.  Input 

COMMON  variables 

d.  Processing 

Create  the  aggregated  JAV  record.  If  all  minimums  and  maximums  are 
zero,  do  not  write  new  record. 

To  prevent  being  written  as  an  "extra"  record,  set  input  strengths 
that  are  used  to  zero  after  storing  the  aggregate  strengths. 

Write  the  JAV  records  by  calling  WRTVAL. 

e.  Output  (via  subroutines) 

Error  Print  file  Logical  unit  13 

Joh  Assignment  Value  file  Logical  unit  39  or  40 

f.  Interfaces 

Called  by:  ISMO 

Calls  to:  WRTERR  (NERR) 

WRTVAL  (IOK) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Codes  for  MAKAGG  are  22,  45. 
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2. 5. 6. 9  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  MAKIND  (IOK) 

b.  Function 


This  subroutine  writes  any  individual  grades  which  should  have  a 
policy  applied  but  which  were  not  included  in  any  of  the  aggregation 
records. 

c.  Input 

COMMON  variables 


d.  Processing 

Create  the  variables  for  writing  a  JAV  record  which  contains  all 
individual  grades  not  included  in  a  grade  aggregation  policy. 

Call  WRTVAL  to  write  a  JAV  record. 


Call  WRTEXT  to  write  the  record  of  unused  data. 


e.  Output  (via  subroutines) 

Error  Print  file 

Combined  ISSUE  and  MOS  Extra  Job  file 
MOS  Extra  Job  file 
ISSUE  Extra  Job  file 
Job  Assignment  Value  file 

f.  Interfaces 

Called  by:  ISMO 

Calls  to:  WRTVAL  (IOK) 

NXTISS 

WRTEXT  (IOK) 


Logical 

unit 

13 

Logical 

unit 

36 

Logical 

unit 

37 

Logical 

unit 

38 

Logical 

unit 

39  or  40 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  MAKIND. 
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2.5.6.10  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  MATPOL  (IOK) 

b.  Function 

To  ensure  that  ISSUE  or  Combined  ISSUE  and  MOS  policies  will  be  set  in 
accordance  with  policies  stated  in  tnims  of  an  Aggregated-ISSUE 
policy,  this  subroutine  finds  the  appropriate  Aggregated-ISSUE 
indicators.  Processing  subsequent  to  this  program  will  check  for 
inconsistencies  between  the  Aggregated-ISSUE  indicators  and  the  ISSUE- 
specific  policies. 

c.  Input 

Aggregated-ISSUE  Indicator  file  Logical  unit  90 

d.  Processing 

If  the  ISSUE  from  the  Aggregated-ISSUE  Indicator  file  is  less  than  the 
job  ISSUE,  get  the  next  Aggregated-ISSUE  Indicator  record. 

If  the  ISSUE  from  the  Aggregated-ISSUE  Indicator  file  is  greater  than 
the  job  ISSUE,  there  are  no  Aggregated-ISSUE  Indicators;  return  zero 
indicators. 

If  the  ISSUE  from  the  Aggregated-ISSUE  Indicator  file  equals  the  job 
ISSUE,  set  the  indicators. 

e.  Output 

COMMON  variables 

Error  Print  file  Logical  unit  13 

f.  Interfaces 
Called  by:  FINDAT 
Calls  to:  WRTERR  (NERR) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Code  for  MATPOL  is  99. 
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2.5.6.11  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  NXTISS 

b.  Function 

This  subroutine  computes  the  subscript  for  setting  characters  5,  6,  7, 
and  8  of  the  "DEMAN"  to  assure  it  is  always  unique. 

c.  Input 

COMMON  variables 

d.  Processing 

When  reading  the  job  (MOS-data)  file  for  the  first  time,  create  the 
DEMAN  name  by  making  characters  5  and  6  nonblank.  All  MOS  records  are 
given  a  unique  permutation  of  two  alphabetic  characters  followed  by 
two  blank  characters. 

During  the  second  pass  through  the  job  file,  use  the  DEMAN  name  set 
during  the  first  pass  and  make  character  7  nonblank. 

During  the  third  pass  through  the  job  file,  use  the  DEMAN  name  set 
•  during  the  second  pass  and  make  character  8  nonblank. 

During  the  final  pass  through  the  job  file,  the  values  (Job  Assignment 
Values)  are  set.  Change  character  8  from  an  alpha  character  to  a  num¬ 
ber.  The  minimum  fill  record  will  end  with  a  1;  the  maximum  fill 
record  will  end  with  a  2. 

e.  Output 

DEMAN  (unique  demand  node  name)  in  COMMON 

Error  Print  file  Logical  unit  13 

f.  Interfaces 

Called  by:  GET JOB 
MAKAGG 
MAKIND 
SETBAS 

Calls  to:  WRTERR  (NERR) 

g.  Arguments.  N/A 
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h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  NXTISS  is  97. 
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2.5.6.12  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  SETPOL  (IOK) 

b.  Function 

This  subroutine  reads  all  of  the  policy  records  which  pertain  to  one 
aggregated-ISSUE,  one  ISSUE,  one  MOS,  or  the  ISSUE/MOS  combination  and 
creates  the  set  of  flags  needed  to  correctly  compute  the  Job  Assign¬ 
ment  Value  data. 

c.  Input  (via  subroutines) 

COMMON  variables 
Aggregated-ISSUE  Policy  file 
ISSUE  Policy  file 
MOS  Policy  file 

Combined  ISSUE  and  MOS  Policy  file 

d.  Processing 

Make  sure  ISSUE  and  MOS  have  not  changed. 

Convert  low  grade  to  integer. 

Convert  high  grade  to  integer. 

Create  flags  for  individual  grade  minimum  and  maximum. 

If  policy  is  for  one  grade,  make  sure  this  policy  is  the  first  for 
this  grade  in  the  set  of  policy  statements. 

Set  flags  if  multiple,  individual  grades. 

Set  flags  if  aggregated  grades. 

Get  next  Policy  record. 

e.  Output  (via  subroutines) 

COMMON  variables 

Aggregated-ISSUE  Indicator  file  Logical  unit  90 

Error  Print  file  Logical  unit  13 


Logical  unit  32 
Logical  unit  33 
Logical  unit  34 
Logical  unit  35 
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f.  Interfaces 

Called  by:  AGISPO 
DOIT 

Calls  to:  GETPOL  (IOK) 

WRTERR  (NERR) 

CONPOL  (NEWPOL) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Codes  for  SETPOL  are  13,  22,  30,  44,  46. 
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2.5.6.13  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  WRTEXT  (IOK) 

b.  Function 

This  subroutine  writes  all  the  unmatched  job  records  to  the  extra 
file. 

c.  Input 

COMMON  variables 

d.  Processing 

Write  the  unmatched  job  records  to  the  extra  file.  Use  format  for 
files  26  through  31  but  replace  UIC  and  ISSUE  with  demand  node  name 
(DEMAN). 

e.  Output 

Error  Print  file  Logical  unit  13 

Combined  ISSUE  and  MOS  Extra  Job  file  Logical  unit  36 
_  MOS  Extra  Job  file  Logical  unit  37 

ISSUE  Extra  Job  file  Logical  unit  38 

f.  Interfaces 

Called  by:  MAKIND 
FINDAT 

Calls  to:  WRTERR  (NERR) 

» 

g.  Arguments 

I OK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  WRTEXT  is  99. 
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2.5.6.14  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  WRTUNF(IOK) 

b.  Function 

This  subroutine  writes  all  of  the  unfilled  job  records. 

c.  Input 

COMMON  variables 

d.  Processing 

Write  to  the  unfilled  jobs  file  the  jobs  for  which  no  policy  and  no 
value  data  were  available. 

e.  Output 

Error  Print  file  Logical  unit  13 

Unfilled  Jobs  (from  Policy  Processor)  file  Logical  unit  50 

f.  Interfaces 

Called  by:  SETBAS 
Calls  to:  WRTERR  (NERR) 

g.  Arguments 

I OK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


i.  Error  Codes.  The  Error  Code  in  WRTUNF  is  99. 


2.5.6.15  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  WRTVAL  (IOK) 

b.  Function 

This  subroutine  writes  all  of  the  Job  Assignment  Value  records. 

c.  Input 

COMMON  variables 

d.  Processing 

Write  Job  Assignment  Value  record 

e.  Output 

Job  Assignment  Value  file  Logical  unit  39  or  40 

f.  Interfaces 

Called  by:  MAKING 
MAKAGG 
SETBAS 

Calls  to:  WRTERR  (NERR) 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  WRTVAL  is  99. 
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2.5.6.16  PROGRAM  DESCRIPTION 

a.  Identification 

Policy  Processor  Utility  Subroutine  -  ZEROIN 

b.  Function 

This  subroutine  zeroes  the  policy  indicators.  It  is  called  prior  to 
starting  a  new  set  of  policies. 

c.  Input 

Policy  indicators  in  COMMON. 

d.  Processing 

Set  all  of  the  policy  indicators  to  zero. 

e.  Output. 

Policy  indicators  in  COMMON 

f.  Interfaces 

Called  by:  AGISMO 
ISMO 

Calls  to:  N/A 

g.  Arguments 

IOK  -  if  set  to  value  other  than  zero,  program  cannot  continue. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  ZEROIN. 


2.5.6.17  PROGRAM  DESCRIPTION 


a.  Identification 

Policy  Processor  Utility  Subroutine  -  ZILCH 

b.  Function 

This  subroutine  sets  the  set  of  policy  output  variables  to  zero  prior 
to  reading  the  next  job  record. 

c.  Input. 

Policy  Output  variables  in  COMMON 

d.  Processing 

Zero  the  set  of  policy  output  variables. 

e.  Output 

Policy  Output  variables  in  COMMON 

f.  Interfaces 

Called  by:  ISMO 
SETBAS 
MAKAGG 

Calls  to:  N/A 

g.  Arguments.  N/A 

h.  Tables  and  Item".  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  ZILCH. 
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Figure  2-5.  Information  Flow  Through  the  Policy  Processor 
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Figure  2-6.  Program  Unit  Hierarchy  -  Policy  Processor 
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Figure  2-6.  Program  Unit  Hierarchy  -  Policy  Processor 
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2.6.  PROGRAM  DESCRIPTION  -  Assignment  Processor.  Subsection  2.6  contains 
a  description  of  the  main  programs  of  the  Assignment  Processor  and  the 
associated  subroutines.  Since  this  processor  does  not  use  the  PRIM 
standard  error  writing  technique,  no  error  codes  exist.  A  complete  listing 
of  the  programs  discussed  in  subsection  2.6  is  listed  below. 


Paragraph 

Program 

Process 

Short  description 

2.6.1 

NETWORKMAIN 

3.0 

Calls  the  five  major 
functions 

2. 6. 1.1 

PRENET 

3.1 

Prepares  data  for  the  network 

2. 6. 1.2 

FORM 

3.2 

Forms  the  network  arcs 

2. 6. 1.3 

SNET 

3.3 

Solves  the  network 

2. 6. 1.4 

REPORT 

3.4 

Creates  the  network  output 
file 

2. 6. 1.5 

POSTNET 

3.5 

Saves  assignments  made  by 

SNET 

2.6.2 

CREAT51 

3.6 

Alternate  method  of  computing 
Unfilled  Job  file,  number  51 

Assignments  are  developed  as  flows  on  arcs  in  a  network  which  defines 
the  personnel  inventory  as  resource  nodes  and  the  jobs  or  authorizations  as 
demand  nodes.  The  flows  are  the  number  of  assignments  made  and  the  arcs 
are  the  hypothetical  links  connecting  jobs  and  inventory.  For  one  MOS, 
each  paygrade  that  has  a  number  of  people  in  the  inventory  that  is  greater 
than  zero  becomes  a  resource  node.  Similarily,  for  every  ISSUE,  each 
paygrade  that  has  at  least  one  authorization  of  the  same  MOS  becomes  a 
demand  node.  Since  the  number  of  resources  must  always  match  the  number  of 
demands,  additional  resource  nodes  called  super  soldiers  and  additional 
demand  nodes  called  super  jobs  are  created  so  that  flows  may  exist  on  arcs 
to  or  from  the  super  nodes  as  needed  for  balancing  the  network.  The  user's 
control  over  the  possible  amount  of  flow  on  each  arc  is  the  minimum  and 
maximum  percentage  fills  which  can  be  entered  in  the  Policy  file  or  the 
Value  file.  The  priority  of  arc  flow  is  determined  by  the  corresponding 
values  obtained  from  those  files. 

The  subroutines  that  are  used  to  solve  the  network  are  a  variation  of 
the  Personnel  Network  (PNET)  presently  (1984)  used  by  MILPERCEN  for 
enlisted  personnel  assignment.  Since  neither  the  subroutines  which  read 
the  input  data  from  unit  15  for  use  in  creating  the  network  arcs  nor  the 
network  solution  subroutines  were  designed  and  programed  at  CAA,  they  are 
described  in  general  terms  only.  The  User  Manual  provided  by  the  vendor 
for  use  with  these  subroutines  (Personnel  Scheduling  Program)  will  be  found 
in  Appendix  D.  The  only  changes  to  these  programs  have  been  minor  format¬ 
ting,  not  to  the  network  logic.  In  addition,  the  main  program  has  been 
changed  to  allow  cycling  through  all  MOS  rather  than  requiring  a  separate 
run  for  each  MOS.  This  has  been  accomplished  by  adding  a  preprocessor 
(PRENET)  prior  to  the  subroutine  FORM,  and  a  postprocessor  (PSTNET)  after 
the  subroutine  REPORT.  Both  PRENET  and  PSTNET  are  subroutines  which  are 
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called  from  the  main  program.  PRENET  generates  the  input  data  required  for 
the  FORM  subroutine  by  reading  four  separate  data  files  and  extracting  the 
required  information.  PSTNET  writes  the  results  of  the  network  to  three 
different  output  files:  one  for  the  actual  job  assignments  made;  one  for 
the  unfilled  jobs;  and  one  for  excess  people.  The  unfilled  job  file 
written  by  PSTNET  is  based  on  the  number  of  jobs  filled  by  super  soldiers; 
the  requirement  for  super  soldiers  is  the  difference  between  the  minimum 
job  requirement  and  the  assignments.  If  the  user  wants  the  unfilled  jobs 
based  on  the  maximum  job  requirement,  CREAT51,  Process  3.6  must  be  run. 

A  set  of  figures  is  provided  to  assist  the  reader  in  understanding  the 
relationship  of  the  Assignment  Processor  programs.  Figure  2-8  shows  the 
information  flow  and  Figure  2-9  provides  the  program  hierarchy.  The 
figures  are  at  the  end  of  section  2-6. 

Since  the  description  of  the  inputs  to  the  FORM  subroutine  in  the 
Personnel  Scheduling  Program  (PSP)  manual  are  difficult  to  understand, 
further  clarification  of  several  important  areas  are  presented  in  this 
section. 

a.  Super  Jobs  and  Super  Soldiers.  Super  jobs  are  imaginary  jobs  to 
which  the  network  can  assign  excess  people.  Super  soldiers  are  imaginary 
people  used  to  fill  jobs  when  there  are  not  enough  projected  people  to  fill 
all  jobs  for  each  MOS.  Super  jobs  must  be  created  by  PRENET  for  each  grade 
level  with  an  inventory  greater  than  zero  in  file  21,  Numbers-of -People 
file.  PRENET  also  creates  super  soldiers,  one  set  for  each  grade  level 
found  in  file  40,  Job  Assignment  Value  file. 

b.  Supersets  and  Subsets.  The  PSP  manual  frequently  uses  the  term 
"subsets"  to  refer  to  an  aggregation  level  that  might  better  be  called  a 
superset  since  it  refers  to  a  higher-  or  less-detailed  level.  For  example, 
if  a  demand  node  name  of  E04-AAA  were  found  in  File  40,  using  the  example 
data  and  files  in  this  manual,  one  could  detemine  that  the  E04-  represents 
the  Eighth  Infantry  Division  which  is  located  in  Europe;  the  higher  aggre¬ 
gation  level  is  named  USAREUR.  (Since  the  demand  node  name  is  seven 
characters  long,  using  information  from  Section  2.5  one  could  also  deter¬ 
mine  that  the  record  was  written  in  response  to  an  MOS  policy.)  The  PSP 
manual  refers  to  E04-AAA  as  the  demand  node  and  USAREUR  as  the  subset; 
programs  and  documentations  produced  by  CAA  will  refer  to  the  aggregation 
level  represented  by  USAREUR  as  the  superset.  In  relation  to  the  grades, 
the  MOS  will  be  called  a  superset  by  CAA  and  a  subset  in  the  PSP  manual. 

Do  not  confuse  superset  with  super  jobs  or  super  soldiers;  there  is  no 
relationship. 

c.  Inputs  to  the  FORM  Subroutine  (file  15) 

(1)  The  initial  name  list  is  no  longer  required  in  the  input  file  15. 
This  data  is  now  passed  from  PRENET  to  the  FORM  subroutine  via  a 
COMMON  block. 

(2)  The  Demand  Data  Section.  The  demand  data  section  consists  of  two 
parts:  real  jobs  and  super  jobs.  Real  jobs  are  determined  by  reading 
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file  40.  Super  jobs  must  be  created  for  each  grade  level  for  which 
there  are  projected  people  (from  file  21)  in  the  MOS  being 
processed. 

(a)  Real  Jobs.  The  first  record  of  the  real  job  indicates  an  ISSUE 
identification  code  and  the  number  of  supersets  to  which  it 
belongs.  In  PRENET,  the  number  of  supersets  for  any  enlisted 
demand  will  always  be  two:  The  higher  aggregation  level,  "US 
Army"  and  the  MOS.  These  two  names  will  appear  in  the  second 
record.  The  MOS  is  requir'  to  link  people,  and  super  soldiers 
to  the  demand.  Otherwise,  the  jobs  requiring  this  MOS  would 
not  be  filled.  The  third  record  indicates  the  aggregate 
minimum  and  maximum  number  of  jobs  for  this  demand.  The  next 
records  indicate  the  minimum  and  maximum  number  of  jobs  broken 
out  by  grade  level  (activity).  The  sum  of  the  minimums  across 
all  grade  levels  cannot  exceed  the  aggregate  maximum  number  of 
jobs  for  this  demand.  Likewise,  the  sum  of  the  maximums  across 
the  grade  level  cannot  be  less  than  the  aggregate  minimum 
number  of  jobs  for  this  demand.  For  each  demand  (ISSUE) 
requiring  the  MOS  being  processed,  the  set  of  four  records  will 
be  generated. 

(b)  Super  Jobs.  Super  jobs  follow  the  actual  jobs.  For  each  grade 
level  for  which  there  are  people  in  the  MOS  being  processed,  a 
super  job  is  created.  Again,  super  jobs  are  used  to  assign 
excess  people  and  do  not  really  exist.  Super  jobs  begin  with 
the  key  word  "SINK."  This  is  followed  by  the  number  of 
supersets  to  which  this  imaginary  job  belongs  and  the  name  of 
the  super  job.  In  this  implementation,  all  super  jobs  begin 
with  "SJ-"  followed  by  the  grade  level.  Thus,  "SJ-E4"  would 
indicate  a  super  job  to  which  people  with  the  rank  of  E4  could 
be  assigned.  Also,  as  with  real  jobs,  only  two  supersets  are 
used.  They  are  the  MOS  and  the  grade  level  and  are  listed  in 
the  second  record  of  the  super  jobs.  The  third  record 
indicates  the  maximum  number  of  people  that  may  be  assigned  to 
the  arc  pointing  to  the  node  from  real  people  with  its  value 
and  the  maximum  number  of  jobs  that  go  toward  the  total  demand 
with  its  value.  The  maximum  numbers  used  will  equal  the  number 
of  people  available  in  each  grade  level.  The  value  has  been 
set  to  negative  ten  (-10). 

(3)  Resources.  The  resource  section  consists  of  two  separate  parts: 
real  people  and  super  soldiers.  Like  super  jobs,  super  soldiers  are 
imaginary  and  are  only  used  by  the  model  to  fill  jobs  for  which  there 
are  no  projected  people  available. 

(a)  Real  People.  The  first  record  consists  of  the  MOS  being 

processed,  the  number  of  supersets  to  which  the  MOS  belongs  and 
the  number  of  demands  to  which  people  of  this  MOS  can  be 
assigned.  In  this  implementation,  the  MOS  is  its  own  superset. 
It  is  used  to  link  the  people  with  this  MOS  to  the  demands  and 


super  jobs.  The  number  of  demands  is  determined  by  counting 
the  number  of  demands  in  the  demand  section.  The  second  record 
contains  the  superset  names,  which  in  this  case  is  only  the 
MOS.  The  third  record  indicates  the  minimum  and  maximum  number 
of  people  that  may  be  assigned  to  the  different  jobs  in  the 
demand  section.  In  this  case,  the  minimum  and  maximum  numbers 
will  be  the  same  and  are  equal  to  the  total  number  of  people  in 
the  inventory  in  this  MOS.  If  there  are  not  enough  actual 
jobs,  then  the  excess  people  will  be  assigned  to  super  jobs. 

The  fourth  record  breaks  out  the  total  people  in  the  inventory 
by  grade  level.  Again,  the  minimum  and  maximum  will  be  the 
same  because  we  want  to  assign  all  people.  The  last  record 
indicates  the  maximum  number  of  people  that  can  be  assigned  to 
a  demand  by  grade  level  along  with  an  associated  preference 
cost  or  value.  There  will  be  one  record  of  this  type  for  each 
of  the  demands  that  were  listed  in  the  demand  section  for  this 
MOS.  The  number  of  these  records  also  corresponds  to  the  last 
value  of  the  first  record  in  the  resource  section. 

(b)  Super  Soldiers.  The  record  format  for  super  soldiers  is 

identical  to  that  of  real  people,  except  that  super  soldiers 
are  identified  by  placing  "SP-"  before  the  MOS  in  the  first 
record.  If  jobs  do  not  exist,  super  soldiers  should  not  be 
assigned,  so  the  minimum  number  of  people  in  records  3  and  4  is 
changed  to  zero.  If  this  number  was  not  zero,  the  model  could 
assign  super  soldiers  to  super  jobs  (the  network  treats  super 
soldiers  the  same  as  real  people).  The  preference  value  in  the 
last  record  for  super  soldiers  is  set  to  a  negative  10  (-10); 
thereby,  when  other  values  are  positive,  forcing  assignment  of 
real  people  to  jobs  prior  to  assignment  of  super  soldiers.  The 
maximum  number  of  super  soldiers  that  could  be  assigned  is  made 
equal  to  the  sum  of  maximum  number  of  jobs  requested  for  each 
demand  in  the  demand  section. 

d.  Assignments.  This  processor  attempts  to  assign  the  minimum  number 
of  people  required  for  each  job  first.  Once  all  jobs  have  their  minimum 
requirement  level  satisfied,  the  remaining  people  will  be  assigned  to  jobs 
having  the  highest  maximum  fill  values  until  the  maximum  number  of  assign¬ 
ments  is  filled.  If  jobs  have  equal  value,  the  job  encountered  first  will 
be  filled  to  its  maximum  level  prior  to  other  jobs  of  the  same  value.  The 
order  of  the  jobs  input  to  the  network  is  not  the  order  actually  used;  the 
network  programs  sort  by  the  size  of  the  fill  value. 

e.  Manual  Discrepancies.  If  any  discrepancy  is  found  between  the  File 
Descriptions,  section  3.3.2,  and  Personnel  Scheduling  Program,  Appendix  D, 
the  correct  version  for  this  application  is  this  section  and  the  File 
Descriptions,  section  3.3.2  of  the  Program  Maintenance  Manual. 


2.6.1  PROGRAM  DESCRIPTION 

a.  Identification 


Assignment  Processor  Main  Program  -  NETWORKMAIN 
Process  Number:  3.0 

b.  Function 

This  program  assigns  the  personnel  inventory  (Number-of-people  file) 
to  jobs  requiring  the  MOS  and  grade  of  the  inventory  personnel; 
assignments  are  made  to  all  grade  levels  of  one  MOS  or  SC.  All  MOS/SC 
are  assigned  by  cycling  through  all  subroutines  for  each  MOS/SC. 

c.  Input  (via  subroutines) 

ISSUE  Definition  file  Logical  unit  14 

Parameter  file  Logical  unit  17 

Number-of-people  file  (Personnel  Inventory)  Logical  unit  21 
Job  Assignment  Value  file  Logical  unit  40 

d.  Processing 

Prepare  input  data  for  network  programs  for  one  MOS  or  SC  using  the 
subroutine  PRENET. 

Build  the  arcs  for  the  network  using  subroutine  FORM. 

Assign  people  to  jobs  using  subroutine  SNET. 

Build  the  Network  Output  file  using  subroutine  REPORT. 

Save  the  assignments,  unfilled  jobs,  and  excess  people  using 
subroutine  PSTNET. 

e.  Output  (via  subroutines) 

Excess  People  from  Regular  Assignment  Logical  unit  41 

Unfilled  Jobs  from  Regular  Assignment  Logical  unit  51 

Assignments  from  Regular  Assignment  Logical  unit  61 

f.  Interfaces 

Calls  to:  PRENET 
FORM 
SNET 
REPORT 
PSTNET 


g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


2.6. 1.1  PROGRAM  DESCRIPTION 


a.  Identification 

Assignment  Processor  Subroutine  -  PRENET 
Process  Number:  3.1 

b.  Function 

This  subroutine  prepares  input  data  for  network  programs  for  one  MOS 
or  SC  each  time  it  is  called. 

c.  Input 

ISSUE  Definition  file  Logical  unit  14 

Parameter  file  Logical  unit  17 

Number-of -people  file  Logical  unit  21 

Job  Assignment  Value  file  Logical  unit  40 

d.  Processing 

Get  the  superset  names  from  the  ISSUE  Definition  file. 

Get  grades  and  number  of  MOS  characters  from  the  Parameter  file. 

Get  the  next  set  of  people  from  the  Number-of -people  file. 

Get  the  matching  set  of  jobs  from  the  JAV  file. 

Write  people  to  Excess  People  file  if  there  are  no  jobs  with  that  MOS 
or  SC. 

Write  jobs  to  Unfilled  Jobs  file  if  there  were  no  people  with  that  MOS 
or  SC. 

Write  Network  Input  file  for  a  set  of  people  and  jobs  that  match  on  SC 
or  MOS. 

e.  Output 

Network  Input  file  Logical  unit  15 

Excess  People  from  Regular  Assignment  Logical  unit  41 

Unfilled  Jobs  from  Regular  Assignment  Logical  unit  51 

f.  Interfaces 


Called  by:  NETWORKMAIN 


g.  Arguments.  N/A 


h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 
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2. 6. 1.2  PROGRAM  DESCRIPTION 

a.  Identification 

Assignment  Processor  Subroutine  -  FORM  (not  written  by  CAA) 

Process  Number:  3.2 

b.  Function 

This  subroutine  creates  the  COMMON  data  needed  for  later  network 
subroutines  and  forms  the  arcs. 

c.  Input 

Network  Input  file  Logical  unit  15 

d.  Processing 

Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  0. 

e.  Output 

Network  Scratch  file  Logical  unit  4 

f.  Interfaces 

Called  by:  NETWORKMAIN 

Calls  to:  Please  refer  to  Appendix  0. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 
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2. 6.1. 3  PROGRAM  DESCRIPTION 

a.  Identification 

Assignment  Processor  Subroutine  -  SNET  (not  written  by  CAA) 

Process  Number:  3.3 

b.  Function 

Assign  the  inventory  of  people  to  the  jobs  using  a  network  solution 
algorithm. 

c.  Input 

Network  Scratch  file  Logical  unit  4 

d.  Processing 

Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 

e.  Output 

Network  Scratch  file  Logical  unit  8 

Network  Scratch  file  Logical  unit  9 

f.  Interfaces 

Called  by:  NETWORKMAIN 

Calls  to:  Please  refer  to  Appendix  D. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 
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2.6.1.4  PROGRAM  DESCRIPTION 

a.  Identification 

Assignment  Processor  Subroutine  -  REPORT  (not  written  by  CAA) 

Process  Number:  3.4 

b.  Function 

This  subroutine  creates  an  output  file  for  the  user  from  the  network 
flows  and,  when  in  standalone  mode  or  flags  are  set  differently, 
creates  printed  output  reports. 


c.  Input 

Network  Scratch  file 

d.  Processing 


Logical  unit  9 


Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 


e.  Output 

Network  Output  file 

f.  Interfaces 

Called  by:  NETWORKMAIN 

Calls  to:  Please  refer  to  Appendix  D. 

g.  Arguments.  N/A 


h.  Tables  and  Items.  Please  refer  to  Appendix  D. 


Logical  unit  2 
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2.6. 1.5  PROGRAM  DESCRIPTION 


a.  Identification 

Assignment  Processor  Subroutine  -  PSTNET 
Process  Number:  3.5 

b.  Function 

This  subroutine  saves  the  assignments  made  by  the  network  program 
(SNET)  and  writes  additional  excess  people  records  and  unfilled  job 
records. 

c.  Input 

Network  Output  file  Logical  unit  2 

d.  Processing 

Read  the  Network  Output  file  which  contains  pointers  to  job  names  and 
number  of  assignments  made. 

Compute  the  number  of  excess  people  {by  getting  the  number  of  people 
assigned  to  super  jobs)  and  write  them  to  the  Excess  People  file. 

Compute  the  number  of  unfilled  jobs  at  each  location  (by  getting  the 

numbers  of  jobs  filled  with  super  soldiers)  and  write  them  to  the 
Unfilled  Jobs  file. 

Write  the  good  assignments  to  the  Assignment  file. 

e.  Output 

Excess  People  from  Regular  Assignment  Logical  unit  41 

Unfilled  Jobs  from  Regular  Assignment  Logical  unit  51 

Assignments  from  Regular  Assignment  Logical  unit  61 

f.  Interfaces 

Called  by:  NETWORKMAIN 
Calls  to:  None 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


2.6.2  PROGRAM  DESCRIPTION 


a.  Identification 

Assignment  Processor  Main  Program  -  CREAT51 
Process  Number  3.6 

b.  Function 

This  program  is  executed  when  the  unfilled  jobs  should  be  based  on  the 
maximum  percentages  rather  than  the  minimums,  where  the  minimums  were 
based  on  the  flow  on  the  arcs  from  super  soldiers  to  actual  jobs.  The 
flow  is  the  number  needed  to  fill  to  the  minimum  percentage  only. 

This  program  overwrites  the  Unfilled  Job  file  from  process  3.5  and 
recreates  the  file  using  the  differences  between  the  maximum  percent¬ 
ages  and  the  numbers  of  real  assignments. 

c.  Input 

Parameter  file  Logical  unit  17 

Job  Assignment  Value  file  Logical  unit  40 

Assignments  from  Regular  Assignment  Logical  unit  61 

d.  Processing 

Get  grades  and  number  of  MOS  characters  from  Parameter  file. 

Get  next  job  and  its  associated  maximum  allowable  assignment  for  each 
grade  level  from  the  JAV  file. 

Get  matching  assignments  from  Assignment  file. 

Compute  any  unfilled  assignments  for  each  grade  level  for  the  job 
being  processed. 

If  there  are  unfilled  assignments,  write  job  to  Unfilled  Job  file  51. 

e.  Output 

Unfilled  jobs  from  Regular  Assignment  Logical  unit  51 

f.  Interfaces.  N/A 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary 


Figure  2-9.  Program  Unit  Hierarchy  (Assignment  Processor) 
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2.7  PROGRAM  DESCRIPTION  -  Substitution  Assignment  Processor.  Subsection 
2.7  contains  a  description  of  the  main  programs  of  the  Substitution 
Assignment  Processor,  Module  1,  Module  2,  and  the  associated  subroutines. 
The  programs  discussed  in  subsection  2.7  are  listed  below. 


Paragraph 

Program 

Process 

Short  description 

2.7.1. 

GRDMAIN 

4.1 

Module  1  -  grade  sub¬ 
stitution  main  program 

2. 7. 1.1 

PREGRD 

4.1.1 

Prepares  data  for  network 
using  grade  substitution 

2. 7. 1.2 

FORM 

4.1.2 

Creates  data  for  network 
using  grade  substitution 

2. 7. 1.3 

SNET 

4.1.3 

Makes  the  assignments 

2. 7. 1.4 

REPORT 

4.1.4 

Creates  the  Network  Output 
file 

2. 7. 1.5 

PSTGRD 

4.1.5 

Saves  data  from  network 
using  grade  substitution 

2.7.2 

MOSMAIN 

4.2 

Module  2  -  MOS  substitution 
main  program 

2. 7. 2.1 

PREMOS 

4.2.1 

Prepares  data  for  network 
using  MOS  substitution 

2. 7.2.2 

FORM 

4.2.2 

Creates  data  for  network 
using  MOS  substitution 

2. 7.2.3 

SNET 

4.2.3 

Makes  the  assignments 

2. 7.2.4 

REPORT 

4.2.4 

Creates  the  Network  Output 
file 

2. 7. 2. 5 

PSTMOS 

4.2.5 

Saves  data  from  network 
using  MOS  substitution 

The  Substitution  Assignment  Processor  is  composed  of  two  modules.  The 
first  module,  Grade  Substitution,  controls  the  processing  for  assignments 
within  matching  MOS  but  across  grades.  The  second  module,  MOS  Substi¬ 
tution,  allows  assignment  of  personnel  of  a  different  MOS  but  of  the  same 
grade.  These  modules  may  be  run  in  either  order.  The  input  for  both 
modules  is  an  Unfilled  Job  file  and  an  Excess  People  file  which  are  output 
from  the  Assignment  Processor  (Processor  3)  or  from  the  other  of  these  two 
modules.  The  correct  file  number  for  the  desired  sequence  is  specified  in 
the  Parameter  file.  It  is  possible  to  execute  either  module  several  times, 
using  the  output  from  one  run  as  the  input  to  the  next  run  by  controlling 
the  file  numbers  via  both  the  Parameter  file  and  the  @USE  statements.  The 
major  requirement  is  that  the  file  numbers  match  Table  2-2.  All  comments 
in  Section  2.6  regarding  network  assignment  also  apply  to  this  processor. 
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Table  2-2.  Substitution  File  Numbers 


Run 

Sequence 

Substitution 

Input 

Output 

Job 

People 

Job 

Peopl 

1 

Grade 

51 

41 

53 

43 

2 

Grade 

52 

42 

53 

43 

1 

MOS 

51 

41 

52 

42 

2 

MOS 

53 

43 

52 

42 

Figure  2-10  shows  the  information  flow,  and  Figure  2-11  shows  the 
relationship  of  the  programs  within  the  Substitution  Assignment  Processor. 
Both  figures  are  at  the  end  of  section  2.7. 
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2.7.1  PROGRAM  DESCRIPTION 

a.  Identification 


Substitution  Assignment  Processor,  Main  Program  for  Module  One  - 
GRDMAIN 

Process  Number:  4.1 

b.  Function 

This  program  assigns  the  excess  people  to  unfilled  jobs  by  making  the 
grade  substitutions  that  are  specified  in  the  Parameter  file.  One  MOS 
or  SC  is  assigned  on  each  pass  through  the  network  subroutine,  SNET. 


c.  Input  (via  subroutines} 

ISSUE  Definition  file 
Parameter  file 
Excess  People  file 
Unfilled  Job  file 

d.  Processing 


Logical  unit  14 

Logical  unit  17 

Logical  unit  41  or  42 

Logical  unit  51  or  52 


Prepare  input  data  for  network  programs  for  one  MOS  or  SC  using  the 
subroutine  PREGRD. 

Build  the  arcs  for  the  network  using  the  subroutine  FORM. 

Assign  excess  people  to  unfilled  jobs  using  subroutine  SNET. 

Build  the  Network  Output  file  using  subroutine  REPORT. 

Save  the  assignments,  the  new  set  of  unfilled  jobs,  and  the  new  excess 
people  using  subroutine  PSTGRD. 


e.  Output  (via  subroutines) 

Excess  People  from  Grade  Substitution 
Unfilled  Jobs  from  Grade  Substitution 
Assignments  from  Grade  Substitution 

f.  Interfaces 

Calls  to:  PREGRO 
FORM 
SNET 
REPORT 
PSTGRD 


Logical  unit  43 
Logical  unit  53 
Logical  unit  53 
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2. 7. 1.1  PROGRAM  DESCRIPTION 


a.  Identification 


Substitute  Assignment  Processor,  Module  1  Subroutine  -  PREGRD 
Process  Number:  4.1.1 


b.  Function 


This  subroutine  prepares  input  data  for  network  programs  for  one  MOS 
or  SC  with  grade  substitution. 


c.  Input 

ISSUE  Definition  file 
Parameter  file 
Excess  People  file 
Unfilled  Jobs  file 

d.  Processing 


Logical  unit  14 

Logical  unit  17 

Logical  unit  41  or  42 

Logical  unit  51  or  52 


Get  the  superset  names  from  the  ISSUE  Definition  file. 


Get  the  grades,  number  of  MOS  characters,  and  grade  substitutions  from 
the  Parameter  file. 


Get  the  next  set  of  people  from  the  Excess  People  file. 

Get  the  matching  set  of  jobs  from  the  Unfilled  Jobs  file. 

Write  people  to  the  Excess  People  file  if  there  are  no  jobs  with  the 
MOS  or  SC. 

Write  jobs  to  the  Unfilled  Jobs  file  if  there  are  no  people  with  that 
MOS  or  SC. 


Write  the  Network  Input  file  for  grade  substitution  using  the  set  of 
people  and  jobs  that  match  on  SC  or  MOS. 

e.  Output 


Network  Input  file 

Excess  People  from  Grade  Substitution 
Unfilled  Jobs  from  Grade  Substitution 

f.  Interfaces 


Logical  unit  15 
Logical  unit  43 
Logical  unit  53 


Called  by:  GRDMAIN 
Calls  to:  None 
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g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 
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2. 7. 1.2  PROGRAM  DESCRIPTION 

a.  Identification 

Substitute  Assignment  Processor,  Module  1  Subroutine  -  FORM  (not 
written  by  CAA) 

Process  Number:  4.1.2 

b.  Function 

This  subroutine  creates  the  COMMON  data  needed  for  later  network 
programs  and  forms  the  arcs. 

c.  Input 

Network  Input  file  Logical  unit  15 

d.  Processing 

Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 

e.  Output 

Network  Scratch  file  Logical  unit  4 

f.  Interfaces 
Called  by:  GRDMAIN 

Calls  to:  Please  refer  to  Appendix  0. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 
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2.7. 1.3  PROGRAM  DESCRIPTION 


a.  Identification 

Substitute  Assignment  Processor  Subroutine  -  SNET  (not  written  by  CAA) 
Process  Number:  4.1.3 

b.  Function 

This  subroutine  assigns  the  inventory  of  people  to  the  jobs  using  a 
network  solution  algorithm. 

c.  Input 

Network  Scratch  file  Logical  unit  4 

d.  Processing 

Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 

e.  Output 

Network  Scratch  file  Logical  unit  8 

Network  Scratch  file  Logical  unit  9 

f.  Interfaces 

Called  by:  GRDMAIN 

Calls  to:  Please  refer  to  Appendix  D. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 


2. 7. 1.4  PROGRAM  DESCRIPTION 


a.  Identification 

Substitute  Assignment  Processor,  Module  1  Subroutine  -  REPORT  (not 
written  by  CAA) 

Process  Number:  4.1.4 

b.  Function 

This  subroutine  creates  an  output  file  for  the  user  from  the  network 
flows,  and,  when  in  standalone  mode  or  flags  are  set  differently, 
creates  printed  output  reports. 

c.  Input 

Network  Scratch  file  Logical  unit  9 

d.  Processing 

Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 

e.  Output 

Network  Output  file  Logical  unit  2 

f.  Interfaces 
Called  by:  GRDMAIN 

Calls  to:  Please  refer  to  Appendix  D. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 
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2. 7. 1.5  PROGRAM  DESCRIPTION 


a.  Identification 

Substitute  Assignment  Procesor,  Module  1  Subroutine  -  PSTGRD. 

Process  Number:  4.1.5 

b.  Function 

This  subroutine  saves  the  assignments  made  by  the  network  program  and 
writes  additional  excess  people  records  and  unfilled  job  records  as 
required. 

c.  Input 

Network  Output  file  Logical  Unit  2 

d.  Processing 

Read  the  Network  Output  file  which  contains  pointers  to  job  names  and 
number  of  assignments  made. 

Compute  the  number  of  excess  people  (by  getting  the  number  of  people 
assigned  to  super  jobs)  and  write  them  to  the  Excess  People  file. 

Compute  the  number  of  unfilled  jobs  at  each  location  (by  getting  the 

numbers  of  jobs  filled  with  super  soldiers)  and  write  them  to  the 
Unfilled  Jobs  file. 

Write  the  good  assignments  to  the  Assignment  file. 

e.  Output 

Excess  People  from  Grade  Substitution  Logical  unit  43 

Unfilled  Jobs  from  Grade  Substitution  Logical  unit  53 

Assignments  from  Grade  Substitution  Logical  unit  63 

f.  Interfaces 
Called  by:  GRDMAIN 
Calls  to:  None 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 
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2.7.2  PROGRAM  DESCRIPTION 


a.  Identification 


Substitute  Assignment  Processor,  Main  Program  for  Module  Two  -  MOSMAIN 
Process  Number:  4.2 

b.  Function 


This  program  assigns  the  excess  people  to  unfilled  jobs  by  making  the 
MOS  substitutions  that  are  specified  in  the  Parameter  file.  One  MOS 
or  SC  is  assigned  at  one  time;  up  to  five  MOS  may  be  substituted. 


c.  Input  (via  subroutines) 


ISSUE  Definition  file 
Parameter  file 
Excess  People  file 
Unfilled  Job  file 

d.  Processing 


Unfilled  Job  file  using  subroutine  PREMOS. 

Build  the  arcs  for  the  network  using  the  subroutine  FORM. 


Logical 

unit 

14 

Logical 

unit 

17 

Logical 

unit 

41  or 

43 

Logical 

unit 

51  or 

53 

one  MOS 

or  SC 

from 

the 

Assign  excess  people  to  unfilled  jobs  using  subroutine  SNET. 
Build  the  network  output  file  using  subroutine  REPORT. 


Save  the  assignments,  the  new  set  of  unfilled  jobs  and  the  new  excess 
people  using  subroutine  PSTMOS. 

e.  Output  (via  subroutines) 


Excess  People  from  MOS  Substitution 
Unfilled  Jobs  from  MOS  Substitution 
Assignments  from  MOS  Substitution 


Logical  unit  42 
Logical  unit  52 
Logical  unit  62 


f.  Interfaces 

Calls  to:  PREMOS 
FORM 
SNET 
REPORT 
PSTMOS 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 
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2. 7. 2.1  PROGRAM  DESCRIPTION 

a.  Identification 

Substitute  Assignment  Processor,  Module  2  Subroutine  -  PREMOS 
Process  Number:  4.2.1 

b.  Function 

This  subroutine  prepares  input  data  for  network  programs  for  one  MOS 
or  SC  with  MOS/SC  substitution  each  time  it  is  called. 

c.  Input 

ISSUE  Definition  file  Logical  unit  14 

Parameter  file  Logical  unit  17 

Excess  People  file  Logical  unit  41  or  43 

Unfilled  Jobs  file  Logical  unit  51  or  53 

d.  Processing 

Get  superset  names  from  ISSUE  Definition  file. 

Get  grades,  number  of  MOS  characters,  and  MOS  and  SC  substitution  from 
Parameter  file. 

Get  the  next  set  of  people  from  the  Excess  People  file. 

Get  the  matching  set  of  jobs  from  the  Unfilled  Jobs  file. 

Write  people  to  Excess  People  file  if  there  are  no  jobs  with  the 
substitute  MOS  or  SC. 

Write  jobs  to  Unfilled  Jobs  file  if  there  were  no  people  who  can  be 
substituted  for  that  MOS  or  SC. 


Write  Network  Input  file  for  MOS  substitution  for  the  set  of  people 
and  jobs  that  match  on  SC  or  MOS  with  substitution. 

e.  Output 


Network  Input  file 

Excess  People  from  MOS  Substitution 

Unfilled  Jobs  from  MOS  Substitution 


Logical  unit  15 
Logical  unit  42 
Logical  unit  52 


f.  Interfaces 


Called  by:  MOSMAIN 


Calls  to:  None 


‘  » 


« 
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g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 


l* 
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2.7 .2.2  PROGRAM  DESCRIPTION 


a.  Identification 


Substitute  Assignment  Processor,  Module  2  Subroutine  -  FORM  (not 
written  by  CAA) 

Process  Number:  4.2.2 


b.  Function 

This  subroutine  creates  the  COMMON  data  needed  for  later  network 
programs  and  forms  the  arcs. 


c.  Input 

Network  Input  file 

d.  Processing 


Logical  unit  15 


Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  0. 


e.  Output 

Network  Scratch  file 


Logical  unit  4 


f.  Interfaces 

Called  by:  MOSMAIN 

Calls  to:  Please  refer  to  Appendix  0. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  0. 
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2. 7. 2. 3  PROGRAM  DESCRIPTION 


a.  Identification 

Substitute  Assignment  Processor  Subroutine  -  SNET  (not  written  by  CAA) 
Process  Number:  4.2.3 

b.  Function 

This  subroutine  assigns  the  inventory  of  people  to  the  jobs  using  a 
network  solution  algorithm. 

c.  Input 

Network  Scratch  file  Logical  unit  4 

d.  Processing 

Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 

e.  Output 

Network  Scratch  file  Logical  unit  3 

Network  Scratch  file  Logical  unit  9 

f.  Interfaces 

Called  by:  MOSMAIN 

Calls  to:  Please  refer  to  Appendix  D. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 
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2. 7.2.4  PROGRAM  DESCRIPTION 

a.  Identification 


Substitute  Assignment  Processor,  Module  2  Subroutine  -  REPORT  (not 
written  by  CAA) 

Process  Number:  4.2.4 

b.  Function 

This  subroutine  creates  an  output  file  for  the  user  from  the  network 
flows,  and,  when  in  standalone  mode  or  flags  are  set  differently, 
creates  printed  output  reports. 


c.  Input 

Network  Scratch  file 

d.  Processing 


Logical  unit  9 


Since  this  subroutine  is  not  a  CAA  program,  the  processing  is  not 
described  in  detail.  Please  refer  to  the  Personnel  Scheduling  Program 
User  Manual,  Appendix  D. 


e.  Output 

Network  Output  file 

f.  Interfaces 


Logical  unit  2 


Called  by:  MOSMAIN 

Calls  to:  Please  refer  to  Appendix  D. 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  D. 
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2. 7. 2. 5  PROGRAM  DESCRIPTION 

a.  Identification 

Substitute  Assignment  Processor,  Module  2  Subroutine  -  PSTMOS 
Process  Number:  4.2.5 

b.  Function 

This  subroutine  saves  the  assignments  made  by  the  network  program  and 
writes  additional  excess  people  records  and  unfilled  job  records  as 
required. 


c.  Input 

Network  Output  file 

d.  Processing 


Logical  unit  2 


Read  the  Network  Output  file  which  contains  pointers  to  job  names  and 
number  of  assignments  made. 

Compute  the  number  of  excess  people  (by  getting  the  number  of  people 
assigned  to  super  jobs)  and  write  them  to  the  Excess  People  file. 

Compute  the  number  of  unfilled  jobs  at  each  location  (by  getting  the 
numbers  of  jobs  filled  with  super  soldiers)  and  write  them  to  the 
Unfilled  Jobs  file. 

Write  the  good  assignments  to  the  Assignment  file. 


e.  Output 

Excess  People  from  MOS  Substitution  Logical  unit  42 

Unfilled  Jobs  from  MOS  Substitution  Logical  unit  52 

Assignments  from  MOS  Substitution  Logical  unit  52 

f.  Interfaces 
Called  by:  MOSMAIN 
Calls  to:  None 

g.  Arguments.  N/A 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 
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Figure  2-10.  Information  Flow  Through  the  Substitute 
Assignment  Processor 
(page  1  of  2  pages) 
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igure  2-11.  Program  Unit  Hierarchy  Substitution 
Assignment  Processor 
(page  2  of  2  pages) 
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2.8  PROGRAM  DESCRIPTION  -  READINESS  PROCESSOR.  Subsection  2.8.  contains  a 
description  of  the  main  program  of  the  Readiness  Processor.  The  Readiness 
Processor  consists  of  one  main  program.  Since  all  input  files  will  have 
been  created  by  previous  processors,  the  assumptions  are  made  that  they 
will  have  all  been  created  correctly  and  that  there  is  no  need  for  error 
messages  to  the  user.  The  Readiness  Processor  combines  the  input 
authorized  and  structure  strengths  with  the  assignments  from  both  of  the 
previous  processors.  During  this  process,  the  Readiness  Processor 
reaggregates  the  multiple  records  produced  by  the  other  processors  back  up 
to  the  ISSUE  level.  Its  final  output  is  the  set  of  files  needed  for  the 
Report  Processor.  These  output  files  have  been  formatted  so  that  they  may 
be  easily  scanned  or  printed  using  the  system  editor.  Figure  2-12,  at  the 
end  of  section  2.8,  shows  the  information  flow  through  the  Readiness 
Processor. 
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2.8.1  PROGRAM  DESCRIPTION 

a.  Identification 

Readiness  Processor  Main  Program,  READYMAIN 
Process  Number  5.0 

b.  Function 

The  Readiness  Processor  computes  the  available  strengths  for  each  MOS 
and  grade  in  each  ISSUE,  computes  the  various  percentages  required  by 
the  reports,  and  computes  the  ISSUE  C-ratings  using  the  criteria  from 
the  Parameter  file. 

c.  Input 

Parameter  file 
Value  file 

MOS-data  (ISSUE  level)  file 
Assignments  from  Regular  Assignment 
Assignments  from  MOS  Substitution 
Assignments  from  Grade  Substitution 

d.  Processing 

Get  the  Parameter  file  data. 

Get  all  ISSUES  from  the  MOS-data  file. 

Get  the  minimum  and  maximum  percentages  from  the  Value  file  for  all 
ISSUEs  found  in  the  MOS-data  file. 

For  each  MOS,  get  the  required  and  authorized  strengths  from  the 
MOS-data  file  and  compute  the  sums. 

Get  assignments  from  regular  assignment  and  compute  available  sums  and 
percentages. 

Repeat  for  assignments  from  grade  substitution  and  then  for  MOS 
substitution. 

Compute  C-ratings. 
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Write  Readiness  files. 
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e.  Output 

Detailed  Readiness  Indicators 
Detailed  Readiness  Indicators  Using 
MOS  Substitution 

Detailed  Readiness  Indicators  Using 
Grade  Substitituion 

Total  Results  including  MOS  Substitution 
Aggregated  Readiness  Indicator  file 
Aggregated  Percentage  and  C-rating  file 
Grade  Readiness  and  Percentage  file 
MOS  Readiness,  Percentage,  and  C-rating 
file 


Logical  unit  64 

Logical  unit  65 

Logical  unit  66 
Logical  unit  67 
Logical  unit  70 
Logical  unit  72 
Logical  unit  73 

Logical  unit  74 


f.  Interfaces 


Arguments.  N/A 


h.  Tables  and  Items. 

Dictionary. 


Please  refer  to  Appendix  A  for  the  Data 


Information  Flow  Through  the  Readiness  Processor 
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2.9  PROGRAM  DESCRIPTION  -  REPORT  PROCESSOR.  This  section  contains  a  de¬ 
scription  of  the  programs  in  the  Report  Processor.  The  Report  Processor 
uses  the  date  and  valid  grade  codes  from  the  Parameter  file  and  the 
Readiness  files  that  were  output  from  the  Readiness  Processor  to  produce 
printed  readiness  reports  that  are  formatted  and  labeled  for  readability. 
Some  readiness  reports  are  produced  at  the  highest  aggregated  level.  Since 
the  Report  Processor  can  be  run  as  frequently  as  desired,  and  any  number  of 
reports  can  be  requested  on  each  run,  the  user  may  request  aggregated  level 
reports  first,  then  choose  detail  reports  for  only  certain  ISSUES  or  MOS. 
See  Table  2-3  for  a  list  of  the  available  readiness  reports.  The  main 
program  that  controls  the  Report  Processor  and  the  11  report  subroutines, 
one  for  each  readiness  report  type,  are  listed  below.  Two  utility 
subroutines,  used  by  the  Report  Processor  subroutines,  are  also  described. 


Figure  2-13  shows  the  informat 
2-14  shows  the  relationship  of 
Both  figures  are  at  the  end  of 


Paragraph  Program 


2.9.1  DRIVE6 

2. 9. 1.1  REPT01 

2. 9. 1.2  REPT02 

2. 9. 1.3  REPT03 

2. 9. 1.4  REPT04 

•  2. 9. 1.5  REPT05 

2. 9. 1.6  REPT06 

2. 9. 1.7  REPT07 

2.9. 1.8  REPT08 

2.9. 1.9  REPT09 

2.9.1.10  REPT10 

2.9.1.11  REPT11 

2.9.1.12  ISSUNA 

2.9.1.13  ZERODV 


on  flow  of  the  Report  Processor,  and  Figure 
the  programs  within  the  Report  Processor, 
section  2.9. 


Process 

Short  description 

6.0 

Report  Processor  main 

program 

6.1 

Subroutine  for  report 

type  1 

6.2 

Subroutine  for  report 

type  2 

6.3 

Subroutine  for  report 

type  3 

6.4 

Subroutine  for  report 

type  4 

6.5 

Subroutine  for  report 

type  5 

6.6 

Subroutine  for  report 

type  6 

6.7 

Subroutine  for  report 

type  7 

6.8 

Subroutine  for  report 

type  8 

6.9 

Subroutine  for  report 

type  9 

6.10 

Subroutine  for  report 

type  10 

6.11 

Subroutine  for  report 

type  11 

utility 

Gets  ISSUE  name 

utility 

Performs  division 
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Table  2-3.  Readiness  Report  Types 


Report 

type 

Report 

subtype 

Report  name 

1 

ISSUE  Summary  Report 

2 

Specialty  Summary  by  Aggregate-ISSUE 

3 

ALL 

Specialty  Summary  by  ISSUE  -  All 
Specialities 

MOS  code 

Specialty  Summary  by  ISSUE  -  Specific 

MOS 

4 

Specialty  Summary  by  Grade 

5 

Grade  Summary  by  Aggregate-ISSUE 

6 

Grade  Summary  by  ISSUE 

7 

High  Five  Summary 

8 

ALL 

ISSUE  Listing  -  All  ISSUES 

ISSUE  code 

Specific  ISSUE  Listing 

9 

C-ratings 

10 

ALL 

Excess  Personnel  -  All  Types 

ORIGINAL 

Excess  Personnel  from  Regular  Assignment 

MOS  SUB 

Excess  Personnel  from  MOS  Substitution 

GRADE  SUB 

Excess  Personnel  from  Grade  Substitution 

11 

ALL 

Unfilled  Jobs  -  All  Types 

ORIGINAL 

Unfilled  Jobs  from  Regular  Assignment 

MOS  SUB 

Unfilled  Jobs  from  MOS  substitution 

GRADE  SUB 

Unfilled  Jobs  from  Grade  Substitution 
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2.9.1  PROGRAM  DESCRIPTION 

I  a.  Identification 

Report  Processor  Main  Program  -  DRIVE6 
Process  Number:  6.0 

b.  Function 

This  program  controls  the  production  of  all  PRIM  formatted  readiness 
reports. 

c.  Input 

|  ISSUE  Definition  file  Logical  unit  14 

Parameter  file  Logical  unit  17 

Report  Request  file  Logical  unit  93 

d.  Processing 

>  Get  ISSUE  names  from  the  ISSUE  Definition  file. 

Get  the  as-of-date  and  grade  parameters  from  the  Parameter  file. 

Get  the  report  number  from  the  Report  Request  file. 

|  Call  the  appropriate  report  subroutine. 

e.  Output 

Count  of  reports  requested 
^  Reports  requested 

f.  Interfaces 

Calls  to:  REPT01 
REPT02 
REPT03 

*  •  REPT04 

REPT05 

REPT06 

REPT07 

REPT08 

REPT09 

*  REPT10 

REPT11 

Called  by:  N/A 

*  .  • 
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2. 9. 1.1  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT01  (IFILE) 

Process  Number:  6.1 

b.  Function 

This  subroutine  produces  report  type  1,  ISSUE  Summary. 

c.  Input 

Aggregated  Readiness  Indicator  file  Logical  unit  70 

d.  Processing 

Presort  the  Aggregated  Readiness  Indicator  file  on  ISSUE. 
Read  the  Aggregated  Readiness  Indicator  file. 

Compute  subtotals  for  both  ISSUE  aggregation  levels. 

Print  the  formatted  report. 

e.  Output 

Issue  Summary  Report  -  Report  #1 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (70) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT01. 
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2. 9. 1.2  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT02  (IFILE) 

Process  Number:  6.2 

b.  Function 

This  subroutine  writes  report  type  2,  Specialty  Summary  by  Aggregated 
ISSUE. 

c.  Input 

MOS  Readiness,  Percentage,  and  C-rating  file  Logical  unit  74 

d.  Processing 

Presort  the  MOS  Readiness  file  on  ISSUE  within  major  aggregation 
level . 

Read  the  MOS  Readiness  file,  aggregate  the  sums  to  the  highest 
aggregation  level,  and  compute  the  percentages. 

Print  the  sums  and  percentages  for  each  major  aggregation,  and  print 
the  sums  across  all  ISSUES  for  each  MOS. 

e.  Output 

Specialty  Summary  by  Aggregated-ISSUE  Report  -  (Report  #2) 

f.  Interfaces 
Called  by:  0RIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (74) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT02. 
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2. 9. 1.3  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT03  ( IF  I LE ,  MOSPAR) 

Process  Number:  6.3 

b.  Function 

This  subroutine  writes  report  type  3,  Specialty  Summary  by  ISSUE. 

c.  Input 

MOS  Readiness,  Percentage,  and  C-rating  file  Logical  unit  74 

d.  Processing 

Sort  the  MOS  Readiness  file  by  ISSUE  within  MOS. 

Read  and  print  the  MOS  Readiness  file. 

Compute  and  print  the  strengths  and  percentages  for  the  lowest  ISSUE 
level,  the  highest  aggregation  level,  and  the  total  Army. 

If  the  report  subtype  is  ALL,  all  specialties  are  listed.  Otherwise, 
only  the  specified  MOS  or  SC  is  listed. 

%.  •  e.  Output 

Specialty  Summary  by  ISSUE  Report  -  (Report  #3) 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IF  I LE  -  Input  file  logical  unit  number  (74) 

MOSPAR  -  The  MOS  which  should  be  printed;  may  be  ALL 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT03. 
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2.9. 1.4  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT04  (IFILE) 

Process  Number:  6.4 

b.  Function 

This  subroutine  writes  report  type  4,  Specialty  Summary  by  Grade. 

c.  Input 

Total  Results  Including  MOS  Substitution  Logical  unit  67 

d.  Processing 

Read  aggregated  strengths  by  grade  within  MOS. 

Print  aggregated  strengths  by  grade  within  MOS. 

e.  Output 

Specialty  Summary  by  Grade  Report  -  (Report  #4) 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (67) 

h.  Tables  and  Items.  Please  refer  to  Appendix  .A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  REPT04  is  30. 


2. 9. 1.5  PROGRAM  DESCRIPTION 


a.  Identification 

Report  Processor  Subroutine  -  REPT05  (IFILE) 

Process  Number:  6.5 

b.  Function 

This  subroutine  writes  report  type  5,  Grade  Summary  by  Aggregated- 
ISSUE. 

c.  Input 

Grade  Readiness  and  Percentage  file  Logical  unit  73 

d.  Processing 

Read  Grade  Readiness  file. 

Aggregate  strengths  by  both  aggregation  levels  and  total  Army. 
Compute  percentages  for  aggregation  levels. 

Print  the  report. 

e.  Output 

Grade  Summary  by  Aggregated  ISSUE  Report  -  (Report  #5) 

f.  Interfaces 
Called  by:  DRIVE6 

g .  Arguments 

IFILE  -  Input  file  logical  unit  number  (73) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  REPT05  is  33. 
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2. 9. 1.6  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT06  (IFILE) 

Process  Number:  6.6 

b.  Function 

This  subroutine  writes  report  type  6,  Grade  Summary  by  ISSUE. 

c.  Input 

Grade  Readiness  file  Logical  unit  73 

d.  Processing 

Read  Grade  Readiness  and  Percentage  file. 

Aggregate  strengths  for  both  aggregation  levels. 

Print  the  report. 

e.  Output 

Grade  Summary  by  ISSUE  Report  -  (Report  #6) 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (73) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  The  Error  Code  in  REPT06  is  33. 
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2. 9. 1.7  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT07  (IFILE) 

Process  Number:  6.7 

b.  Function 

This  subroutine  writes  report  type  7,  High-5  Summary. 

c.  Input 

Aggregated  Readiness  Indicator  file  Logical  unit  70 

d.  Processing 

Read  Aggregated  Readiness  Indicator  file. 

Compute  totals  and  subtotals  of  high  five  enlisted  grades  fill 
information  for  each  ISSUE. 

Print  the  report. 

e.  Output 

High-5  Summary  Report  -  (Report  #7) 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (70) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT07. 
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2. 9. 1.8  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT08  (IFILE1,  IFILE2,  IFILE3,  IFILE4, 
FIELD) 

Process  Number:  6.8 

b.  Function 

This  subroutine  writes  report  type  8,  ISSUE  Listing.  For  each  ISSUE, 
the  ISSUE  Listing  report  contains  data  aggregated  across  all  grades 
and  MOS,  aggregates  of  the  High-5  enlisted  grades,  senior  grade 
aggregates,  data  for  each  grade  aggregated  across  all  MOS,  and 
detailed  information  by  grade  and  MOS. 

C-  Input 

Aggregated  Readiness  Indicator  file 
Grade  Readiness  and  Percentage  file 
MOS  Readiness,  Percentage,  and  C-rating  file 
Detailed  Readiness  Indicators 

d.  Processing 

Read  files. 

Sort  files  by  ISSUE,  grade,  and  specialty. 

Read  from  files  70,  73,  74,  and  64. 

Print  aggregated  data  for  the  ISSUE  (aggregate,  High-5,  senior  grade). 
Print  aggregated  grade  data. 

For  each  MOS,  print  data  aggregated  over  all  grades  and  detail  for 
each  grade. 

If  subtype  is  ALL,  all  ISSUEs  are  listed.  Otherwise,  only  the 
specified  ISSUE  is  listed. 

e.  Output 

ISSUE  Listing  Report  -  (Report  #8) 

f.  Interfaces 

Called  by:  DRIVE6 


Logical  unit  70 
Logical  unit  73 
Logical  unit  74 
Logical  unit  64 


5 


g.  Arguments 


IFIL£1=70 

IFILE2=73  logical  unit  numbers  of  input  files 
IF ILE3=74 
IF I LE4=64 

FIELO=report  subtype.  Valid  entries  are  ALL  or  a  valid  ISSUE  code. 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT08. 


2. 9.1. 9  PROGRAM  DESCRIPTION 


a.  Identification 

Report  Processor  Subroutine  -  REPT09  (IFILE) 

Process  Number:  6.9 

b.  Function 

This  subroutine  writes  report  type  9,  C-rating  report. 

c.  Input 

Aggregated  Percentage  and  C-rating  file  Logical  unit  72 

d.  Processing 

Read  Aggregated  Percentage  and  C-rating  file. 

List  C-ratings. 

e.  Output 

C-rating  Report  -  (Report  #9) 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (72) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT09. 
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2.9.1.10  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Subroutine  -  REPT10  (IFILE) 

Process  Number:  6.10 

b.  Function 

This  subroutine  writes  report  type  10,  Excess  Personnel. 

c.  Input 

Excess  People  from  Regular  Assignment  Logical  unit  41 

Excess  People  from  MOS  Substitution  Logical  unit  42 

Excess  People  from  Grade  Substitution  Logical  unit  43 

d.  Processing 

Read  appropriate  file. 

Print  out  personnel  specified. 

e.  Output 

Excess  Personnel  Report  -  (Report  #10) 

f.  Interfaces 
Called  by:  0RIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (41,  42,  or  43) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT10. 


2.9.1.11  PROGRAM  DESCRIPTION 


a.  Identification 

Report  Processor  Subroutine  -  REPT1I  (IFILE) 

Process  Number:  6.11 

b.  Function 

This  subroutine  writes  report  type  11,  Unfilled  Jobs  by  grade,  MOS, 
and  ISSUE. 

c.  Input 

Unfilled  Jobs  from  Policy  Processor  Logical  unit  50 

Unfilled  Jobs  from  Regular  Assessment  Logical  unit  51 

Unfilled  Jobs  from  MOS  Substitution  Logical  unit  52 

Unfilled  Jobs  from  Grade  Substituion  Logical  unit  53 

d.  Processing- 

Read  appropriate  file. 

Print  unfilled  jobs. 

e;  Output 

Unfilled  Jobs  Report  -  (Report  #11) 

f.  Interfaces 
Called  by:  DRIVE6 

g.  Arguments 

IFILE  -  Input  file  logical  unit  number  (50,  51,  52,  53) 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 

i.  Error  Codes.  There  are  no  Error  Codes  in  REPT11. 


2.9.1.12  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Utility  Subroutine  -  ISSUNA  (Issue,  ISSNAM,  KERR) 

b.  Function 

This  subroutine  finds  the  ISSUE  name  that  matches  the  input  ISSUE 
code. 

c.  Input 

Subroutine  Arguments 

ISSUE  Definition  file  Logical  Unit  14 

d.  Processing 

Read  the  ISSUE  file. 

If  an  ISSUE  code  is  found  that  matches  the  input  ISSUE,  set  ISSNAM  to 
the  corresponding  ISSUE  name. 

If  an  ISSUE  code  is  not  found  that  matches  the  input  ISSUE,  write 
error  message  number  9. 

Rewind  the  ISSUE  file  and  return. 

e.  Output 

Subroutine  Argument  -  ISSNAME 

f.  Interfaces 

Called  by:  Report  Processor  Subroutines 
Calls  to:  None 

g.  Arguments 

ISSUE  -  Characters  ISSUE  code  to  be  matched 
ISSNAM  -  Character*12  ISSUE  name 
KERR  -  Integer  error  indicator 

h.  Tables  and  Items.  Please  refer  to  Appendix  A  for  the  Data 
Dictionary. 
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2.9.1.13  PROGRAM  DESCRIPTION 

a.  Identification 

Report  Processor  Utility  Subroutine  -  ZERODV  (A,  B,  C) 

b.  Function 

This  subroutine  is  used  to  assure  that  a  percentage  computation  does 
not  divide  by  zero. 

c.  Input 

Subroutine  Arguments  -  A  and  B 

d.  Processing 

Set  quotient  to  zero. 

If  number  to  be  divided  is  greater  than  zero  and  divisor  is  zero,  set 
quotient  to  very  large  number  (to  provide  visual  signal  on  the 
output) . 

If  both  the  number  to  be  divided  and  the  divisor  are  greater  than 
zero,  perform  the  division. 

e.  Output 

Subroutine  Argument  -  C 

f.  Interfaces 

Called  by:  Report  Processor  subroutines 
Calls  to:  None 

g.  Arguments 

A  -  Real  The  number  to  be  divided 
B  -  Real  The  divisor 
C  -  Real  The  quotient 

h.  Tables  and  Items.  No  variable  names  are  used  except  A,  B,  and  C. 
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2.10  PROGRAM  DESCRIPTION  UTILITIES.  The  programs  described  in  this 
section  are  the  PRIM  utility  subroutines.  They  are  considered  utility 
routines  because  they  perform  their  function  for  more  than  one  processor. 
Most  of  the  utility  routines  would  be  useful  in  other  programs.  In  fact, 
many  of  these  were  originally  programed  for  use  in  different  models  and 
have  been  included  in  PRIM  because  of  their  utility. 


Paragraph  Program  Function 


2.10.1  APRTCA  Print  heading  on  each  page  of  alternate  print 

file 

2.10.2  F2FPTS  Temporarily  modify  operating  system  to  allow 

files  numbered  to  99 

2.10.3  GETDAY  Get  the  run  date  and  convert  to  DD  MMM  YY 

2.10.4  GETWCT  Get  wall  clock  time  or  elapsed  time 

2.10.5  ICHINT  Convert  character  to  integer 

2.10.6  ICOMP  Compare  two  alphanumeric  variables 

2.10.7  RCHFLT  Convert  character  to  real 

2.10.8  TITLE  Print  title  page 

2.10.9  WRTERR  Write  an  error  message  to  file  13 
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2.10.1  PROGRAM  DESCRIPTION 

a.  Identification 

Utility  subroutine  APRTCA  (file  number,  heading) 

b.  Function 

This  subroutine  creates  a  heading  on  an  alternate  print  file  such  as 
would  have  been  created  as  a  result  of  @HDG.  In  PRIM,  APRTCA  is  used 
for  the  alternate  print  file  for  error  and  warning  messages  since  HDG 
cannot  be  used. 

c.  Format  Provided 
Relocatable 

d.  Arguments 

File  number  Integer  The  number  of  the  file  that  has  been  defined 

as  an  alternate  print  file 

Heading  Alphanumeric  "H,U,,  characters  actually  printed"  The  first 

six  characters  are  specifically  "H,U,,  followed 
by  the  line  you  want  printed  as  the  heading 
followed  by  a  closing  quote  (") 

e.  Arguments  changed  by  this  program 

None 

f.  Example 

Call  APRTCA(13,"H,U,,P  RIM  ERROR  S") 
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2.10.2  PROGRAM  DESCRIPTION 

a.  Identification 
Utility  program  F2FRT$ 

b.  Function 

This  program  temporarily,  for  the  length  of  the  run  only,  modifies  the 
computer  operating  system  to  allow  ASCII  FORTRAN  to  read  and  write 
file  numbers  from  zero  through  99. 

c.  Format  Provided 

Symbolic  Assembly  Language  Program 

d.  Accessed  by:  (1)  Compile  using  the  @MASM  statement,  and  (2)  In  the 
mapping  element,  between  the  @MAP  and  END  statements,  include  the  following 
image: 


PFPRIM-REL.F2FRT 


e.  Code 


@MASM,  IS 
FSFRT 
PR 
PU 
CR 
RR 
END 
@E0F 


PFPRIM-SYMB.F2FRT,  PFPRIM-REL.F2FRT 
99 
6 
1 
5 
0 
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2.10.3  PROGRAM  DESCRIPTION 

a.  Identification  • 

Utility  subroutine  GETOAY  (RUNDAY) 

b.  Function 

This  subroutine  returns  the  run  date  in  the  form  DD  MMM  YY  when  • 

provided  the  date  in  the  form  YYMMDD. 

c.  Format  Provided 

Symbolic  # 

d.  Arguments 

RUNDAY  CHARACTER*9 

e.  Arguments  changed  by  this  program  ^ 

RUNDAY 

f.  Example 

Input  RUNDAY  =  840817  *  '  »"'* 

Output  RUNDAY  =  17  Aug  84 


•  • 
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2.10.4  PROGRAM  DESCRIPTION 

a.  Identification 

Utility  subroutine  GETWCT  (ISH,  ISM,  ISS,  EH,  EM,  ES) 

b.  Function 

When  ISH,  ISM,  and  ISS  all  equal  zero  on  input,  wall  clock  time  is 
returned  in  EH,  EM,  and  ES. 

When  ISH,  ISM,  and  ISS  are  not  zero,  elapsed  time  since  the  time 
represented  by  ISH,  ISM,  and  ISS  is  returned  in  EH,  EM,  and  ES. 

c.  Format  Provided 

Symbolic 


d.  Arguments 


ISH 

Integer 

The 

hour  of  the  start  time  for  this  computation 

ISM 

Integer 

The 

minute  of  the  start  time  for  this 

computation 

ISS 

Integer 

The 

second  of  the  start  time  for  this 

computation 

EH 

Integer 

The 

elapsed  time  number  of  hours 

EM 

Integer 

The 

elapsed  time  number  of  minutes 

ES 

Integer 

The 

elapsed  time  number  of  seconds 

e.  Arguments  changed  by  this  program 


CAA-D-84-2 


2.10.5  PROGRAM  DESCRIPTION 

a.  Identification 

Utility  function  ICHINT  (ALPHA,  BEGIN,  LENGTH,  FLAG) 

b.  Function 

The  utility  converts  a  character  variable  to  an  integer. 

c.  Format  Provided 

Symbolic 


d.  Arguments 


ALPHA 

Character 

The  alphanumeric  representation  of  the  integer 

BEGIN 

Integer 

The  number  of  the  beginning  character  for 
conversion 

LENGTH 

Integer 

The  number  of  characters,  including  BEGIN,  to 
convert 

FLAG 

Integer 

A  flag  which  indicates  whether  conversion 

concluded  normally 
FLAG=0,  Conversion  O.K. 

FLAG^O,  Conversion  not  O.K.,  usually 
because  invalid  characters  found 

e.  Arguments  changed  by  this  program 

FLAG 

f.  Example 

CHARACTERS  ALPHA 
INTEGER  FLOW 

FLOW  =  ICHINT(ALPHA,  1,  4,  IFLAG) 

IF( I  FLAG  .NE.  0)  PRINT  *,'ERR0R  IN  CONVERSION  OF',  ALPHA 
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2.10.6  PROGRAM  DESCRIPTION 

a.  Identification 

Utility  function  IC0MP2  (ALPHAl,  BEGINl,  ALPHA2,  BEGIN2,  LENGTH) 

b.  Function 

The  utility  compares  two  alphanumeric  variables.  Value  returned  is 
negative  if  the  first  variable  is  smallest,  zero  if  they  are  equal, 
positive  if  the  first  is  the  largest. 

c.  Format  Provided 

Symbolic 


d.  Arguments 


ALPHAl 

BEGIN1 

Alphanumeric 

Integer 

First  variable 

Character  number  within 

ALPHAl  to 

start 

ALPHA2 

BEG1N2 

Alphanumeric 

Integer 

comparison 

Second  variable 
Character  number  within 

ALPHA2  to 

start 

LENGTH 

Integer 

comparison 

Number  of  characters  to 

compare 

e.  Arguments  changed  by  this  program 

None 


f.  Example 

CHARACTER*6  ALPHAl,  ALPHA2 

IVAL  =  IC0MP2  (ALPHAl,  1,  ALPH2,  1,  3) 

IF( IVAL  .GE.  0) 

THEN  do  computations  desired  when  the  first  three  characters  of 
ALPHA2  are  greater  than  or  equal  to  the  first  three  characters 
of  ALPHAl. 

ELSE,  do  computations  desired  when  the  first  three  characters  of 
ALPHA2  are  less  than  the  first  three  characters  of  ALPHAl. 

ENDIF 
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2.10.7  PROGRAM  DESCRIPTION 

a.  Identification 

Utility  function  RCHFLT  (ALPHA,  BEGIN,  LENGTH,  FLAG) 

b.  Function 

The  utility  converts  a  character  variable  to  a  real  number  (floating 
point) . 

c.  Format  Provided 

Symbolic 


d.  Arguments 


ALPHA 


BEGIN 

LENGTH 


Character 

Integer 

Integer 

Integer 


The  alphanumeric  representation  of  the  real 
variable 

The  number  of  the  beginning  character  for 
conversion 

The  number  of  characters,  including  BEGIN, 
to  convert 

A  flag  which  indicates  whether  conversion 
concluded  O.K. 

FLAG=0  =  O.K. 

FLAG#)  =  Not  O.K. 


e.  Arguments  changed  by  this  program 


f.  Example 

CHARACTERS  ALPHA 
REAL  NUMBER 

NUMBER  =  RCHFLT(ALPHA,  1,  9,  IFLAG) 

IF ( IFLAG  .NE.  0)  PRINT  *,  '  ERROR  IN  CONVERSION  OF',  ALPHA 
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2.10.8  PROGRAM  DESCRIPTION 

a.  Identification 

Utlity  program  OTITLE, option  A1,A2,A3,A4,A5 

b.  Function 

The  program  prints  a  page  of  large  characters  as  specified  in  A1 
through  A5. 

c.  Format  Provided 

Executable  (absolute)  element 

d.  Options 

D  =  Insert  the  run  date  in  the  location  specified  by  two  adjacent 
commas 


e.  Arguments 

Al  through  A5 


Each  variable  will  be  a  full  line  of  print  and  may 
be  words  or  any  other  combination  of  alphabetic 
characters,  blank,  dash  (-),  or  numbers.  The 
maximum  length  of  each  is  10  characters.  When  a 
blank  should  be  inserted  within  the  10  characters, 
signify  the  place  by  inserting  a  dollar  sign  ($) 


f.  Example 


@TITLE,D  THIS$RUN, IS$AS$0F, ,PLF 

will  print  in  very  large  letters,  if  this  is  30  June  1984: 

THIS  RUN 
IS  AS  OF 
84  06  30 
PLF 
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2.10.9  PROGRAM  DESCRIPTION 

a.  Identification 

Utility  subroutine  WRTERR  (NERR) 

b.  Function 

The  subroutine  writes  an  appropriate,  PRIM-specif ic  message  for  each 
error  found  in  the  Preprocessor,  Policy  Processor,  or  Report 
Processor . 

c.  Format  Provided 
Symbolic 

d.  Arguments 

NERR  -  the  error  number.  See  list  at  Appendix  E. 

e.  Arguments  changed  by  this  program 

None 
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SECTION  3 


ENVIRONMENT 


3.1  EQUIPMENT  ENVIRONMENT 

The  PRIM  is  resident  on  the  UNIVAC  1100/82  Timesharing  Multiprocessing  Sys¬ 
tem  at  the  US  Army  Military  Personnel  Center  (MILPERCEN).  Access  to  the 
MILPERCEN  system  is  provided  through  terminal  devices  located  in  the  work 
areas  of  MILPERCEN  analysts.  The  PRIM  draws  significantly  on  available 
system  main  and  mass  memory  resources  during  execution.  As  a  result,  it 
will  be  necessary  to  anticipate  and  schedule  the  run  workload  into  the 
overall  run  mix  in  order  to  maintain  satisfactory  throughput. 

3.2  SUPPORT  SOFTWARE 

In  the  event  that  any  changes  to  the  model  code  are  to  be  made,  the  PRIM 
requires  the  availability  of  the  UNIVAC  ASCII  FORTRAN  compiler,  the  associ¬ 
ated  subroutines,  and  the  system  collector.  Each  PRIM  module  that  uses  a 
file  number  larger  than  30  makes  a  temporary  modification  to  the  file  refer¬ 
ence  table.  Assuming  upward  compatibility  of  the  software  system  revisions, 
any  level  subsequent  to  the  10R1  level  of  the  FORTRAN  compiler  should  be 
compatible  with  the  code.  In  addition,  the  PRIM  requires  the  use  of  the 
UNIVAC  utility  processor,  SORT,  level  13,  or  a  version  compatible  with  level 


3.3  DATA  BASES 

The  major  input  data  bases  are  the  available  inventories  and  the  job  auth¬ 
orizations  or  requirements.  Both  of  these  data  bases  can  be  created  from 
other  data  available  at  MILPERCEN.  The  available  inventories  should  be 
developed  as  a  summary  by  MOS  and  grade  of  every  MOS  or  SC  in  the  format 
shown  for  the  Numbers-of-people  file,  file  number  21.  The  job  authoriza¬ 
tions  or  requirements  should  be  specified  by  MOS,  grade,  and  UIC  in  the 
format  shown  for  the  Input  MOS  file,  file  number  8. 

•  The  Preprocessor  aggregates  the  MOS  or  job  data  and  the  unit  data  to 
the  levels  of  aggregation  specified  by  the  user  in  the  ISSUE  file  and 
the  Parameter  file.  The  ISSUE  file  specifies  the  desired  aggregation 
for  units;  the  Parameter  file  specifies  the  specialty  aggregation 
levels.  Files  created  by  the  Preprocessor  are  the  UlC-data  (three- 
digit)  files  and  the  MOS-data  files  at  six-digit,  three-digit,  and 
ISSUE  levels. 

•  The  Policy  Processor  applies  the  user-supplied  policies  from  the 
Policy  file  and  the  Value  file  to  create  the  Job  Assignment  Value 
file  and  the  first  Unfilled  Job  file.  Interim  files  produced  are  the 
Aggregated-ISSUE  Policy  file,  ISSUE  Policy  file,  MOS  Policy  file, 
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Combined  ISSUE  and  MOS  Policy  file.  Combined  ISSUE  and  MOS  Extra  Job 
file,  MOS  Extra  Job  file,  ISSUE  Extra  Job  file,  Aggregated-ISSUE 
Indicator  file,  and  Edited  Policy  file. 

•  The  Assignment  Processor  combines  the  Job  Assignment  Value  file  and 
the  Numbers-of-people  file  to  create  the  interim  file.  Network  Input 
file.  The  final  output  files  from  this  processor  are  the  Unfilled 
Jobs  from  Regular  Assignment  file,  the  Excess  People  from  Regular 
Assignment  file,  and  the  Assignments  from  Regular  Assignment  file. 
Interim  files  used  by  the  network  module  are  the  Network  Output  file, 
three  Network  Scratch  files,  and  the  Network  Input  file.  In  addition, 
binary  files  are  used  for  passing  integer  information  from  one  module 
to  another  in  the  Assignment  processor.  The  use  of  these  files 
decreases  the  amount  of  memory  required  by  the  programs. 

•  The  Substitute  Assignment  Processor  uses  the  output  files  from  the 
Assignment  Processor  (Excess  People,  Unfilled  Jobs  and  Assignments) 
and  the  network  module  revises  the  same  interim  files  as  were  used  by 
the  Assignment  Processor.  Output  files  are  the  Excess  People  from 
MOS  Substitution  file.  Excess  People  from  Grade  Substitution  file. 
Unfilled  Jobs  from  MOS  Substitution  file.  Unfilled  Jobs  from  Grade 
Substitution  file.  Assignments  from  MOS  Substitution  file,  and  Assign¬ 
ments  from  Grade  Substitution  file. 

•  The  Readiness  Processor  uses  the  assignment  files,  excess  people  files, 
and  the  unfilled  jobs  files  created  by  both  the  Assignment  Processor 
and  the  Substitute  Assignment  Processor  plus  the  MOS-data  ISSUE-level 
file  to  create  the  Readiness  files— Aggregated  Readiness  Indicator 
file.  Aggregate  Percentage  and  C-^Rating  file.  Grade  Readiness  file, 

and  MOS  Readiness  file. 

•  The  Report  Processor  uses  the  Readiness  files  to  create  the  formated 
readiness  reports  using  directions  from  the  Report  Request  file. 

3.3.1  General  Characteristics.  Numerous  files  are  created  by  PRIM  to  pass 
information  from  one  module  or  processor  to  another  as  described  below: 

•  Network  Input.  This  file  is  created  by  the  assignment  processors  to 
feed  the  demand  and  resource  data  to  the  network  module.  See  Table 
3-1  for  the  file  identification  of  mass  storage  file  number  2. 

•  Error  Print.  This  file  is  an  alternate  print  file  on  mass  storage. 

See  Table  3-1  for  the  file  identification  of  mass  storage  file  number 
13. 

•  ISSUE.  This  file  specifies  the  aggregation  levels  for  the  units  and 
provides  the  identification  method  and  values  for  the  aggregation. 

The  ISSUE  file  is  created  by  the  user  on  mass  storage.  See  Table  3-1 
for  the  file  identification  of  mass  storage  file  number  14. 
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•  Value.  The  user  creates  this  mass  storage  file  to  specify  the  mini¬ 
mum  percentage  fills  and  the  values  of  filling  to  that  level.  A 
separate  input  is  required  for  each  ISSUE  specified  on  the  ISSUE  file. 
This  file  also  contains  the  maximum  percentage  fill  for  each  ISSUE 
and  the  value  of  each  assignment  between  the  minimum  level  and  the 
maximum  level.  See  Table  3-1  for  the  identification  of  mass  storage 
file  number  19. 

•  Number-of-People.  This  file  contains  the  entire  personnel  inventory 
by  grade  and  specialty  code.  It  may  contain  enlisted,  officer,  or 
any  combination  of  enlisted  and  officer  data.  The  location  of  data 
for  each  pay  grade  on  this  mass  storage  file  must  be  specified  on  the 
Parameter  file.  See  Table  3-1  for  the  identif ication  of  mass  storage 
file  number  21. 

•  UlC-data.  The  data  for  this  set  of  mass  storage  files  are  information 
about  the  units  that  will  be  used  to  aggregate  them  to  ISSUE  level. 

The  source  could  be  the  header  record  from  the  Authorization  Data 
Base.  See  Table  3-1  for  the  identification  of  these  four  mass  storage 
files,  file  numbers  22,  23,  24,  and  25. 

•  MOS-data  (six  digits).  These  files  contain  the  required  and  author¬ 
ized  personnel  by  specialty  and  grade  for  every  unit.  See  Table  3-1 
for  the  identification  of  these  four  files,  mass  storage  file  numbers 
8,  26,  27,  and  28. 

•  MOS-data  (three-digit  and  ISSUE).  These  files  are  aggregations  of 
the  six-digit  MOS-data  file,  first  at  the  three-digit  UIC  level,  then 
at  the  ISSUE  level.  All  pay  grades  are  combined  and  similar  records 
are  combined  so  that  the  final  MOS-data  file  contains  one  record  for 
each  unique  combination  of  ISSUE  and  specialty.  See  Table  3-1  for 
the  identification  of  these  three  files,  mass  storage  file  numbers 
29,  30,  and  31. 

•  Extra  Job  Data.  When  the  Policy  Processor  is  able  to  match  a  policy 
with  an  MOS-data  record,  the  data  needed  by  the  Assignment  Processor 
is  created  and  written  to  the  Job  Assignment  Value  file.  However, 
the  MOS-data  records  that  cannot  be  matched  to  a  policy  are  considered 
extra  or  unused  job  data  for  that  pass.  This  extra  data  is  written 

to  an  extra  job  data  file  (in  a  format  similar  to  the  MOS-data  files) 
for  use  as  MOS-data  on  the  next  pass  through  the  Policy  Processor. 

The  Value  file  is  applied  to  the  final  extra  job  data  file  with  all 
unmatched  MOS-data  written  to  an  Unfilled  Job  file.  See  Table  3-1 
for  the  identification  of  mass  storage  files  numbered  36,  37,  and  38. 

•  Job  Assignment  Value  (JAV).  Two  files  are  used  by  the  Policy  Pro¬ 
cessor  to  store  the  minimum  and  maximum  number  of  assignments  and  the 
value  of  making  these  assignments  for  each  job.  They  are  used  alter¬ 
nately,  with  the  output  file  on  one  pass  becoming  the  input  file  for 
the  next  pass.  See  Table  3-1  for  the  identification  of  the  mass 
storage  JAV  files  numbered  39  and  40. 
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•  Excess  People.  This  set  of  files  is  created  as  outputs  from  the 
Assignment  Processor  (file  41)  and  the  Substitute  Assignment  Processor 
(file  42  and  43),  then  as  inputs  to  the  Readiness  Processor,  and  to 
Report.  See  Table  3-1  for  identification  of  mass  storage  files  num¬ 
bered  41  through  44. 

•  Unfilled  Jobs.  This  set  of  files  is  first  created  as  outputs  from 
the  Policy  Processor  (file  50)  and  the  Assignment  Processor  (file 
51).  These  are  then  used  as  input  to  the  Substitute  Assignment  Pro¬ 
cessor  which  creates  files  52  and  53.  These  are  input  to  the  Read¬ 
iness  Processor  and  to  the  Report  Processor.  See  Table  3-1  for 
identification  for  mass  storages  files  numbered  50  through  54. 

•  Assignments.  These  files  are  first  created  from  the  Assignment  Pro¬ 
cessor  (file  61)  and  the  Substitute  Assignment  Processor  (files  62 
and  63).  These  are  then  used  as  input  to  the  Readiness  Processor. 

See  Table  3-1  for  identification  of  mass  storage  files  61  through  63. 

•  Readiness  Indicators.  This  set  of  files  contains  outputs  from  the 
Readiness  Processor  for  use  in  formatted  readiness  reports.  Files 
numbered  64  through  67  contain  the  detail  data  for  each  MOS  and  grade 
in  every  ISSUE.  Files  numbered  70  and  72  are  data  aggregated  to  ISSUE 
level;  file  73  contains  the  data  for  each  grade  level  in  each  ISSUE, 
aggregated  across  all  MOS;  and  file  74  contains  the  data  for  each  MOS 
in  each  ISSUE-,  aggregated  across  grades.  See  Table  3-1  for  identifi¬ 
cation  of  mass  storage  files  64  through  67,  70,  72,  73,  and  74. 

•  Aggregated- ISSUE  Indicator.  This  is  an  interim  file  produced  by  the 
Policy  Processor.  It  contains  the  Aggregated-ISSUE  Policies  converted 
to  the  flags  that  are  used  within  the  Policy  Processor.  See  Table 
3-1  for  the  identification  of  mass  storage  file  90. 

•  Policy.  The  unedited  Policy  file  is  created  by  the  user  and  edited 

by  the  Policy  Processor  by  comparing  data  from  the  Parameter  and  ISSUE 
files  with  the  input  Policy  file.  The  edited  Policy  file  is  written 
to  file  92.  See  Table  3-1  for  identification  of  mass  storage  files 
91  and  92. 

•  Report  Request.  This  is  the  user's  interface  with  the  Report 
Processor.  If  this  file  is  empty,  no  formatted  readiness  reports 
will  be  produced.  See  Table  3-1  for  identif ication  of  mass  storage 
file  93. 
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Table  3-1.  File  Identification 


l 

Logical 

unit 

number 

Description 

Mass 

storage 

name 

2 

Network  Output  File 

PFNET0UT2 

•■.•-I 

B 

8 

M0S  File 

PFINPUTM0S3 

< 

* 

13 

Error  Print  File 

PFERR0R13 

14 

ISSUE  Definition  File 

PFISSUE14 

15 

Network  Input  File 

PFNETIN15 

17 

Parameter  File 

PFPARAMET17 

19 

Value  File 

PFVALUE19 

21 

Number  of  People  File 

PFNUMBPE0P21 

r 

22 

UlC-data  (6-digit  level)  File 

PFUIC6DIG22 

23 

UlC-data  (3-digit  level)  File 

PFUIC3DIG23 

24 

UlC-data  (3-digit  with  ISSUE  added)  File 

PFUICDATA24 

25 

UlC-data  (3-digit  with  ISSUE  added)  File 

PFUICDATA25 

26 

MOS-En listed  File 

PFM0S-ENL-26 

27 

MOS-Offi cer  File 

PFM0S-0FF-27 

28 

MOS-Warrant  Officer  File 

PFM0S-W0-28 

29 

MOS-data  (3-digit  level)  File 

PFM0SDATA29 

: 

• 

30 

MOS-data  (3-digit  with  ISSUE  added)  File 

PFM0SDATA30 

31 

MOS-data  (ISSUE  level)  File 

PFM0SISSUE31 

32 

Aggregated  ISSUE  Policy  File 

PFAGISP032 

33 

ISSUE  Policy  File 

PFISSP0L33 

34 

MOS  Policy  File 

PFM0SP0L34 

35 

Combined  ISSUE  and  MOS  Policy  File 

PFISM0P035 

36 

Combined  ISSUE  and  MOS  Extra  Job  File 

PFISM0EX36 

1  • 

37 

MOS  Extra  Job  File 

PFM0SEXT37 

38 

ISSUE  Extra  Job  File 

PFISSEXT38 

r. 

39 

Job  Assignment  Value  File  (scratch) 

PFJ0BASVAL39 

40 

Job  Assignment  Value  File  (final) 

PFJ0BASVAL40 

_  ■ 

41 

Excess  People  (from  Regular  Assignment)  File 

PFEXCPE0P41 

42 

Excess  People  (from  MOS  Substitution)  File 

PFEXPE0M0S42 

43 

Excess  People  (from  Grade  Substitution)  File 

PFEXPE0GRA43 

f 

44 

Excess  People  (Scratch)  File 

PFEXPE0M0S44 

v  - 4 

50 

Unfilled  Jobs  (from  Policy  Processor)  File 

PFUNFILLED50 

51 

Unfilled  Jobs  (from  Regular  Assignment)  File 

PFUNFILLED51 

52 

Unfilled  Jobs  (from  MOS  Substitution)  File 

PFUNFILLM052 

53 

Unfilled  Jobs  (from  Grade  Substitution)  File 

PFUNFILLGR53 

’ 

54 

Unfilled  Jobs  (Scratch)  File 

PFUNFILLED54 

61 

Assignment  (from  Regular  Assignment)  File 

3FASSIGNED61 

• 

62 

Assignment  (from  MOS  Substitution)  File 

PFASSIGNM062 

63 

Assignment  ( from  Grade  Substitution)  File 

PFASSIGNGR63 

64 

Assignment  (from  Regular  Assignment  Plus  Percentages)  File 

PFASSIGNED64 

65 

Assignment  (from  MOS  Substitition  Plus  Percentages)  File 

3FASSIGNM065 

66 

Assignment  (from  Grade  Substition  Plus  Percentages)  File 

PFASSIGNGR66 

67 

Total  Results  including  MOS  Substitution  File 

PFASSIGNED67 

70 

Aggregated  Readiness  Indicator  File 

PFISSREADI70 

A 

72 

Aggregated  Percentage  and  C-Rating  File 

PFISSPERCR72 

73 

Grade  Readiness  and  Percentage  File 

PFGRAREADI 73 

. 

74 

MOS  Readiness,  Percentage,  and  C-Rating  File 

3FM0SREADI74 

« 

35 

Strength-by-grade  Print  File 

PFGRASTREN85 

36 

Strength-by-MOS  Print  File 

3FM0S57RE.N86 

90 

Aggregated  ISSUE  Indicator  File 

PFiJi S IND90 

91 

Pol  icy  File 

3F?0L:CY91 

92 

Edited  Pol  icy  File 

3PT-)  T  pO|  JO 

• 

• 

93 

Report  Request  File 

3‘rRE30R'r93 

* 

CAA-D-84-2 


3.3.2  Organization  and  Detailed  Description.  The  description  of  the 
layout  of  every  mass  storage  file  described  in  Section  3.3.1,  General 
Characteristics,  is  provided  in  this  section.  The  files  are  listed  in  the 
same  general  sequence  as  Section  3.3.1.  The  sequence  is  the  same  as  the 
logical  unit  number  used  in  the  programs;  the  unit  file  number  is  provided 
with  each  description.  Each  file  is  described  on  a  separate  page. 


CAA-D-84-2 


NETWORK  OUTPUT  FILE 
FILE  NUMBER  2 

Record  Length:  N/A 
Storage  Medium:  Mass  Storage 
Source  File:  15 

First  Use:  Output  from  Assignment  Processor,  Subroutine  SNET 


Description 


IDIFF 


IDIFF2 


IDIFF3 


IDIFF4 


Resource  (personnel) 

Category:  points  to  MOS  in 
(NAMES)  array 

Activity:  points  to 
grade  in  (IACT)  array 

Demand  (job  identifier):  points 
to  job  in  (NAMES)  array 

Number  of  people  assigned  to  job 

People  assigned  to  super  job  = 
excess  people 

Super  people  assigned  to  job  = 
unfilled  job 


Binary 


Binary 


Binary 


Binary 
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INPUT  MOS  FILE 
FILE  NUMBER  8 

Record  Length:  42  characters 
Storage  Medium:  Mass  Storage 
Source  File:  AUD8 

First  Use:  Input  to  Preprocessor,  Module  1.1. 2.1,  Separate  MOS  data 


Name 

Description 

Position 

Format 

— 

Filler 

1 

A1 

UIC 

6-Digit  unit  identification  code 

2-7 

A6 

— 

Filler 

8-14 

A7 

GRADE 

Pay  grade 

15-16 

A2 

CMF 

Career  Management  Field 

17-18 

A2 

MOS 

Military  occupational  specialty  code 

19-27 

A9 

— 

Filler 

28-31 

A4 

I  DENT 

Person  identity  code 

32 

A1 

REQSTR 

Required  (structure)  strength 

33-35 

13 

AUSTR 

Authorized  strength 

36-38 

13 

_  _ 

Filler 

39-42 

14 

3-8 
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ERROR  PRINT  FILE 
FILE  13 

Record  Length:  132  characters 
Storage  Medium:  Mass  Storage 
Source  File:  N/A 


Name  Description  Position  Format 


Error  description  1-132  A-132 


♦Each  record  is  variable  in  length  and  contains  error  number  and  descrip¬ 
tion  of  error  found. 
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ISSUE  DEFINITION  FILE 
FILE  NUMBER  14 


Record  Length:  62  characters 
Storage  Medium:  Mass  Storage 
Source  File:  PFPRIM-FILES 


First  Use: 

Input  to  Preprocessor,  Module  1.2,  Set  ISSUE 

• 

Name 

Description 

Position 

Format 

-- 

ISSUE= 

1-6 

A6 

ISSUE 

ISSUE  code 

7-10 

A4 

— 

ID1= 

11-14 

A4 

ID1 

First  identification 

Method 

Valid  entries  are: 

TPSN 

UIC3 

UIC6 

AS  GMT 

ASGMT1 

15-20 

A6 

— 

=  sign 

21 

Al 

IDIVAL 

First  identification  method  value 

22-27 

A6 

— 

ID2= 

28-31 

A4 

ID2 

Second  identification  method.  Valid 
entries  are: 

LOCCO 

STACO 

AS  GMT 

32-37 

A6 

— 

=  sign 

38 

Al 

ID2VAL 

Value  of  second  identification  method 

39-44 

A6 

— 

NAME= 

45-49 

A5 

ISSNAM 

Name  of  ISSUE  for  report  purposes 

50-62 

Al  2 

i 


CAA-0-84-2 

NETWORK  INPUT  FILE 
FILE  15 

Source  File:  21,  40 

Created  by:  PRETEST  (3.1),  PREMOS  (4.1.1),  PREGRO  (4.2.1) 

Note:  This  file  contains  six  sets  of  records.  Within  each  set  are  one  to 
four  record  types.  Records  must  be  input  in  the  following  order. 

Set  one:  Demand  —  Type  1,  2,  3,  and  4 

Set  two:  Demand  Sink  (Super  Jobs)  —  Types  1,  2,  and  3 

Set  three:  End  Demand  —  Type  1 

Set  four:  Resource  —  Type  1,  2,  3,  4,  and  5 

Set  five:  Resource  Sink  (Super  Soldiers)  —  Type  1,  2,  3,  4,  and  5 
Set  six:  End  Resource  —  Type  1 

MNEMONIC  DESCRIPTION 

///////////////////////// 

SET  ONE:  DEMAND  RECORDS 

///////////////////////// 

—DEMAND  RECORD  TYPE  ONE 

One  per  Job  Assignment  Value  Record  for  an  MOS 

DEMAN  Demand  node  name  (job  identifier) 

Created  by  adding  two  to  four  alpha¬ 
numeric  characters  to  the  ISSUE  code 

NSUPST  Number  of  supersets  that  include  this 
DEMAN 

—DEMAND  RECORD  TYPE  TWO 

One  for  each  demand  record  type  one 


TYPE  EXAMPLE 

A8  F01-QEA2 

12 
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NETWORK  INPUT  FILE 

FILE  15,  cont. 

MNEMONIC  DESCRIPTION 

TYPE 

EXAMPLE 

SUBSET  Superset  names:  US  ARMY  and  MOS 

A8 

11A1 

These  names  are  used  to  link  the  job 
(DEMAN)  to  the  available  inventory 
i.e.,  if  the  job  and  the  inventory 
have  the  same  MOS  as  a  super  set 
name  (see  inventory  resource  section, 
record  type  2  below),  then  a  link  is 
created 

—DEMAND  RECORD  TYPE  THREE 

One  for  each  demand  record  type  one 

AGGMIN  Minimum  number  of  people  that  must  be  110 

assigned  to  the  DEMAN 

AGGMAX  Maximum  number  of  people  that  may  be  110 

assigned  to  the  DEMAN 

—DEMAND  RECORD  TYPE  FOUR 

One  to  four  for  each  demand  record  type  one 

GRAMIN  Minimum  number  of  peonle  that  must  be  110 

assigned  to  this  DEMAN;  one  minimum  for 
each  grade 

GRAMAX  Maximum  number  of  people  that  may  be  110 

assigned  to  this  DEMAN;  one  maximum 
for  each  grade 

NOTE:  These  numbers  are  input  as  pairs. 

One  GRAMIN  and  one  GRAMAX  for  the 
first  valid  grade,  then  one  GRAMIN 
and  one  GRAMAX  for  the  next  valid 
grade,  etc.,  until  the  number  of 
pairs  is  equal  to  N GRADE  in  the 
parameter  file.  Four  sets  fit 
on  each  record 
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NETWORK  INPUT  FILE 

FILE  15,  cont. 

MNEMONIC  DESCRIPTION 

///////////////////// 

SET  TWO:  DEMAND  SINK 

///////////////////// 

—SINK  RECORD  TYPE  ONE 

One  per  valid  grade  level 

'SINK'  Identifies  beginning  of  sink  area 
('SINK'  is  followed  by  4  blanks) 

NSUPST  Number  of  supersets  to  which  the  sink 
belongs 

'SJ-xxx'  Name  of  the  super  job.  For  regular 
assignment,  the  name  is  created  by 
concatinating  SJ-  with  the  grade  code, 
followed  by  two  blanks.  For  MOS  sub¬ 
stitution,  the  blank  is  replaced  with 
'-A'  or  ' -F ' 


— SINK  RECORD  TYPE  TWO 

One  per  superset  record  type  one 

SUPSET  Superset  names:  grade  and  MOS 

The  number  of  names  listed  must  be 
equal  to  NSUPST 

—SINK  RECORD  TYPE  THREE 

One  per  MOS 

MOS  MOS  of  the  super  job  (will  be  the  same 

as  the  MOS  of  the  jobs  listed  above 

NUMPEO  The  number  of  people  that  may  be  assigned 
to  this  super  job.  The  ' PRE — '  programs 
set  this  to  the  number  of  people 
available  in  the  inventory  for  this 
grade  level  and  MOS 


TYPE 


A8 

13 

A8 


A8 


A8 

19 


CAA-D-84-2 


EXAMPLE 


SINK 


SJ-ES 

SJ-EE5-A 


E6 

100A 


1  IB 
54 
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NETWORK  INPUT  FILE 
FILE  15,  cont. 

MNEMONIC  DESCRIPTION  TYPE 

VALUE  The  value  associated  with  assigning  13 

personnel  to  this  imaginary  job.  The 
1 PRE  — 1  programs  set  this  value  to  -10 

VALUE  Same  as  above  13 

NUMPEO  Same  as  above  19 


iiiiii  iiiiiiiiii  nn,  mn  nn 

SET  THREE:  END  DEMAND  RECORDS 

nnnnnnnnnnnnmm 

—END  DEMAND  RECORD 

One  per  MOS 

'END  DEM'  Signal  that  the  end  of  the  demand  A8 

section  has  been  reached 

/////////////////// 

SET  FOUR:  RESOURCE 

/////////////////// 

—RESOURCE  RECORD  TYPE  ONE 

One  per  MOS 


MOS 

Name  of  resource  (for  grade 
substitution;  '-GRADE'  is 
concatenated  to  MOS) 

A8 

NSUPST 

Number  of  supersets  to  which  this 
resource  belongs;  usually  one 

13 

NJ08S 

Number  of  jobs  (ISSUEs)  to  which 
this  MOS  can  be  assigned 

no 

EXAMPLE 

-10 

-10 


END  DEM 

76Y 

11B-GRADE 


3-14 


AD-A149  505 


UNCLASSIFIED 


PERSONNEL  READINESS  INDICATOR  MODEL  (PRIM) 
DOCUMENTATION  PROGRAM  MAINTENANCE  NANUAUU)  ARMV 
CONCEPTS  ANALVSIS  AGENCV  BETHESDA  MD 
S  J  VAN  NOSTRAND  ET  AL.  NOV  84  CAA-D-84-2  F/G  9/2 


NL 


NETWORK  INPUT  FILE 
FILE  15,  cont. 

MNEMONIC  DESCRIPTION 


CAA-D-84-2 


SUPSET 

NUMBEO 

NUMPEO 

NBY6 

NBY6 

DEMAND 

GRAVAL 

GRAMAX 


TYPE  EXAMPLE 


—RESOURCE  RECORD  TYPE  TWO 

Name  of  Superset  (normally 
MOS)  for  linking  MOS  to  jobs 

—RESOURCE  RECORD  TYPE  THREE 

Minimum  number  of  people  in  the 
aggregate  that  are  available  for 
assignment 

Maximum  number  of  people  in  the 
aggregate  that  are  available  for 
assignment;  normally  equal  to  NUMBEO 

—RESOURCE  RECORD  TYPE  FOUR 

Minimum  number  of  people  in  the 
aggregate  that  are  available  for 
assignment  in  the  grade 

Maximum  number  of  people  in  the 
aggregate  that  are  available  for 
assignment  in  the  grade 

—RESOURCE  RECORD  TYPE  FIVE 

One  for  each  possible  real  job  to 
which  this  MOS  can  be  assigned 

Job  name 

Value  associated  with  job 

Maximum  number  of  people  by  grade 
that  can  be  assigned  to  this  job 

NOTE:  These  numbers  are  input  as 

pairs  similar  to  demand  record 
type  four 


A8  1  IB 

54 
76Y 


110 

110 


no 

no 


A8  A01-AQC2 
F01-QEA2 
19 

19 


Y 
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NETWORK  INPUT 
FILE  15,  cont. 


MNEMONIC  DESCRIPTION  TYPE 

/////////////////////// 

SET  FIVE:  SUPER  SOLDIERS 

/////////////////////// 

—SUPER  SOLDIERS  RECORD  TYPE  ONE 
One  set  per  MOS 


'SP'-MOS  Name  of  super  soldiers.  ' SP '  is  A8 

concatenated  to  the  front  of  MOS 

NSUPST  Number  of  supersets  to  which  this  13 

resource  belongs 

NJOBS  Number  of  jobs  requiring  this  MOS  110 

-SUPER  SOLDIERS  RECORD  TYPE  TWO 
SUPSET  Name  of  superset  (MOS)  A8 

—SUPER  SOLDIERS  RECORD  TYPE  THREE 

MINPEO  Minimum  number  of  super  soldiers  that  110 

must  be  assigned  (normally  zero) 

MAXPEO  Maximum  number  of  super  soldiers  that  110 

may  be  assigned.  The  'PRE — '  pro¬ 


grams  set  this  value  equal  to  the  total 
number  of  jobs  in  DEMAN 

—SUPER  SOLDIERS  RECORD  TYPE  FOUR 

One  set  for  each  grade 

MINPEO  Minimum  number  of  super  soldiers  by  110 

grade  (zero) 


1^ i 


EXAMPLE 


SP-11B 

1 

11B 

76Y 
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NETWORK  INPUT 
FILE  15,  cont. 


CAA-D-84-2 


MNEMONIC 

DESCRIPTION 

TYPE 

EXAMPLE 

MAXPEO 

Maximum  number  of  super  soldiers 
by  grade.  Usually  equal  to  GRAMAX 

—SUPER  SOLDIERS  RECORD  TYPE  FIVE 

One  for  each  possible  job  (DEMAN) 

110 

DEMAND 

Job  name 

A8 

F01-QEA2 

GRAVAL 

Value  associated  with  filling  this 
job  with  super  soldiers 

19 

-10 

MAXNEO 

Maximum  number  of  super  soldiers 

19 

by  grade  (GRAMAX) 

////////////////////// 

SET  SIX:  END  RESOURCE 
////////////////////// 

—END  RESOURCE  RECORD  TYPE  ONE 

'END  RES'  Signal  that  the  end  of  the  resource  A7  END  RES 

section  has  been  reached 


CAA-D-84-2 

PARAMETER  FILE 
FILE  NUMBER  17 

Record  Length:  66  characters 

Storage  Medium:  Mass  Storage 

Use:  Input  to  all  modules  of  all  processors 

Source  File:  PFPRIM-FILES 

This  file  contains  three  record  types. 

Name  Description 


(RECORD  TYPE  1  -  REQUIRED) 
Mnemonic  searched  for: 


Position  Format 


ASOF 

MOSSUB 

MOSJOB 

C3VALA 

NGRADE 

SCDSUB 

GRDPEO 

C1VALM 

NCHENL 

ENLSUB 

GRDJOB 

C2VALM 

NCHOFF 

OFFSYB 

NONAVA 

C3VALM 

NCHWOF 

TYPSTR 

C1VALA 

NCCHAR 

MOSPEO 

C2VALA 

-- 

=  sign 

7 

Al 

ALPHA 

Alphanumeric  of  1  to  6  characters,  left 
justified 

8-13 

A6 

-- 

Filler 

14 

Al 

DESCRI 

Description 

(RECORD  TYPE  2  -  REQUIRED  -  GRADE  LOCATIONS) 

15-80 

A66 

— 

Filler 

1-4 

A4 

GRADE 

Two-character  grade  designation,  the  first  of 
these  should  be  the  second  after  NGRADE 

5-6 

A2 

— 

=  sign 

7 

Al 

I GRADE 

Relative  location  of  grade  data.  If  pay 
grade  will  not  be  specifically  in  the  input 
files,  this  location  should  be  set  to  zero 

8-9 

12 

— 

Filler 

10-14 

A5 

DESCRI 

Description  15-80 

(RECORD  TYPE  3  -  OPTIONAL  -  SUBSTITUTION  INFORMATION) 

A66 

Filler 

1 

Al 

FROM 

'GRADE  FROM'  or  '  MOS  FROM'  or  '  SC  FROM' 

2-11 

A10 

_ 

*  sign 

12 

Al 

GRDFRM 

or 

MOSFRM 

Grade  or  specialty  the  substitution 
is  from 

13-21 

A9 

TO 

•GRADE  TO'  or  '  MOS  TO1  or  '  SC  TO' 

22-29 

A8 

... 

=  sign 

30 

Al 

GRDTO 
or  MOSTO 

Grade  or  MOS  the  substitution  is  to 

31-39 

A9 

•  *,* 


VALUE  FILE 
FILE  NUMBER  19 


CAA-D-84-2 


Record  Length:  62  characters 
Storage  Medium:  Mass  Storage 
Source  File:  PFPRIM-FILES 

First  Use:  Input  to  Policy  Processor,  Module  2.3,  Set  Base  Values 


Mnemonic 

Description 

Position 

Format 

ISSALP 

'ISSUED 

1-6 

A6 

ISSUE 

ISSUE  code 

7-10 

A4 

Filler  (blank) 

11 

Al 

— 

'MINIMUM3 ' 

12-19 

A8 

PERMIN 

Minimum  percentage  fill  stated  as 
decimal  rate 

20-24 

F5.3 

— 

Filler  (blank) 

25 

Al 

— 

‘MINVAL3' 

26-32 

A  7 

VALUE 

Value  of  filling  each  job  up  to  minimum 
percentage 

33-35 

13 

-- 

Filler  (blank) 

36-38 

A3 

— 

‘MAXIMUM3’ 

39-46 

A8 

PERMAX 

Maximum  percentage  fill 

47-51 

F5.3 

— 

Filler  (blank) 

52 

Al 

‘MAXVAL=‘ 

53-59 

A7 

VALUE2 


Value  of  filling  each  job  above  the 
minimum  percentage  (PERMIN)  up  to 
the  maximum  (PERMAX) 


60-62 


13 


CAA-D-84-2 


T. 


» 


3) 

. 

c 


s 


NUMBER  OF  PEOPLE  FILE 
FILE  NUMBER  21 

Record  Length:  143  characters 
Storage  Medium:  Mass  Storage 
Source  File:  N/A 

First  Use:  Input  to  Assignment  Processor,  Subroutine  PRENET 


Name 

Description 

Position 

Format 

ASDAT 

As  of  date  of  data 

1-6 

16 

CMF 

Career  management  field 

7-8 

A2 

MOS 

MOS  if  enlisted  data;  SC  if  officer. 

As  of  Sep  83,  only  data  for  first  3 
characters  is  available;  space  is 
provided  for  all  9 

9-17 

A9 

NEl  ' 

18-24 

17 

NE2 

25-31 

17 

NE3 

32-38 

17 

NE4  1 

39-45 

17 

NE5 

"  Number  of  people  available  in  each 

46-52 

17 

NE6 

enlisted  grade  of  El  through  E7 

53-59 

17 

NE7 

60-66 

17 

NE8 

67-73 

17 

NE9  > 

74-80 

17 

NENLIS  Total  number  of  enlisted  personnel 

El  through  E9 

81-87 

17 

NWO 

Total  number  of  warrant  officers 

88-94 

17 

N01 

95-101 

17 

N02 

102-108 

17 

N03 

Number  of  officers  in  grade  01 

109-115 

17 

N04 

through  06 

116-122 

17 

N05 

123-129 

17 

N06 

130-136 

17 

NOFF 

Total  number  of  officers  in  grades 

01  through  06 

137-143 

17 
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UIC-OATA  (6-OIGIT  LEVEL)  FILE 
FILE  NUMBER  22 

Record  Length:  97  characters 
Storage  Medium:  Mass  Storage 
Source  File:  AUDB 


First  Use: 


Input  to  Preprocessor  Module  1.1.1,  Roll  UIC  data  to  3-digit 
UIC  level 


Name 

Description 

Position 

Format 

„ 

Filler 

1 

Al 

UIC 

UIC  code 

2-7 

A6 

— 

Filler 

8-11 

A4 

COMPO 

Component 

12 

Al 

UNTDS 

Unit  description 

13-33 

A21 

TYPCO 

Unit  type 

34 

Al 

ASGMT 

MACOM  or  organization 

35-36 

A2 

TPSN 

Troop  program  sequence  number 

37-41 

A5 

STACO 

Station  code 

42-46 

A5 

STNNM 

Station  name 

47-55 

A9 

LOCCO 

Location  code 

56-58 

A3 

STSOFF 

Structure  strength  officers 

59-62 

14 

STSWOF 

Structure  strength  warrant  officers 

63-66 

14 

STSENL 

Structure  strength  enlisted 

67-70 

14 

STSAGG 

Structure  strength  aggregate  military 

71-74 

14 

STSCIV 

Structure  strength  civilian 

75-78 

14 

AUSOFF 

Authorized  strength  officers 

79-82 

14 

AUSWOF 

Authorized  strength  warrant  officers 

83-86 

•14 

AUSENL 

Authorized  strength  enlisted 

87-90 

14 

AUSAGG 

Authorized  strength  aggregate  military 

91-94 

14 

AUSCIV 

Authorized  strength  civilian 

95-98 

14 

CAA-D-84-2 

UIC-DATA  (3-DIGIT  LEVEL)  FILE 
FILE  NUMBER  23 

Record  Length:  97  characters 
Storage  Medium:  Mass  Storage 
Source  File:  22 

First  Use:  Output  from  Preprocessor,  Module  1.1.1,  Roll  UIC  data  to  3- 
digit  UIC  level 


Name 

Description 

Position 

Format 

UIC 

UIC  code 

1-6 

A6 

— 

Filler 

7-10 

A4 

COMPO 

Component 

11 

Al 

UNTDS 

Umt  description 

12-32 

A21 

TYPCO 

Unit  type 

33 

Al 

AS  GMT 

MACOM  or  organization 

34-35 

A2 

TPSN 

Troop  program  sequence  number 

36-40 

A5 

STACO 

Station  code 

41-45 

A5 

STNNM 

Station  name 

46-54 

A9 

LOCCO 

Location  code 

55-57 

A3 

STSOFF 

Structure  strength  officers 

58-62 

15 

STSWOF 

Structure  strength  warrant  officers 

63-67 

15 

STSENL 

Structure  strength  enlisted 

68-72 

15 

STSAGG 

Structure  strength  aggregate  military 

73-77 

15 

STSCIV 

Structure  strength  civilian  (set  to  zero) 

78-82 

15 

AUSOFF 

Authorized  strength  officers 

83-87 

15 

AUSWOF 

Authorized  strength  warrant  officers 

88-92 

15 

AUSENL 

Authorized  strength  enlisted 

93-97 

15 

AUSAGG 

Authorized  strength  aggregate  military 

98-102 

15 

AUSCIV 

Authorized  strength  civilian  (set  to  zero) 

103-107 

15 

3-22 


UIC-DATA  (3-DIGIT  WITH  ISSUE  ADDED)  FILE 
FILE  NUMBER  24 

Record  Length:  97  characters 
Storage  Medium:  Mass  Storage 
Source  File:  23,  25 

First  Use:  Output  from  Preprocessor,  Module  1.2,  Set  ISSUE 


Name 

Description 

Position 

Format 

UIC 

UIC  code 

1-6 

A6 

ISSUE 

ISSUE  code  from  ISSUE  file 

7-10 

A4 

COMPO 

Component 

11 

A1 

UNTDS 

Unit  description 

12-32 

A21 

TYPCO 

Unit  type 

33 

A1 

AS  GMT 

MACOM  or  organization 

34-35 

A2 

TPSN 

Troop  program  sequence  number 

36-40 

A5 

STACO 

Station  code 

41-45 

A5 

STNNM 

Station  name 

46-54 

A9 

LOCCO 

Location  code 

55-57 

A3 

STSOFF 

Structure  strength  officers 

58-62 

15 

STSWOF 

Structure  strength  warrant  officers 

63-67 

15 

STSENL 

Structure  strength  enlisted 

68-72 

15 

STSAGG 

Structure  strength  aggregate  military 

73-77 

15 

STSCIV 

Structure  strength  civilian  (set  to  zero) 

78-82 

15 

AUSOFF 

Authorized  strength  officers 

83-87 

15 

AUSWOF 

Authorized  strength  warrant  officers 

88-92 

15 

AUSENL 

Authorized  strength  enlisted 

93-97 

15 

AUSAGG 

Authorized  strength  aggregate  military 

98-102 

15 

AUSCIV 

Authorized  strength  civilian  (set  to  zero) 

103-107 

15 

CAA-D-84-2 

UIC-DATA  (3-DIGIT  WITH  ISSUE  ADDED)  FILE 
FILE  NUM8ER  25 

Record  Length:  97  characters 
Storage  Medium:  Mass  Storage 
Source  File:  24 

First  Use:  Output  from  Preprocessor,  Module  1.2,  Set  ISSUE 


Name 

Description 

Position 

Format 

UIC 

UIC  code 

1-6 

A6 

ISSUE 

ISSUE  code  from  ISSUE  file 

7-10 

A4 

COMPO 

Component 

11 

A1 

UNTDS 

Unit  description 

12-32 

A21 

TYPCO 

Unit  type 

33 

A1 

AS  GMT 

MACOM  or  organization 

34-35 

A2 

TPSN 

Troop  program  sequence  number 

36-40 

A5 

STACO 

Station  code 

41-45 

A5 

STNNM 

Station  name 

46-54 

A9 

LOCCO 

Location  code 

55-57 

A3 

STSOFF 

Structure  strength  officers 

58-62 

15 

STSWOF 

Structure  strength  warrant  officers 

63-67 

15 

STSENL 

Structure  strength  enlisted 

68-72 

15 

STSAGG 

Structure  strength  aggregate  military 

73-77 

15 

STSCIV 

Structure  strength  civilian  (set  to  zero) 

78-82 

15 

AUSOFF 

Authorized  strength  officers 

83-87 

15 

AUSWOF 

Authorized  strength  warrant  officers 

88-92 

15 

AUSENL 

Authorized  strength  enlisted 

93-97 

15 

AUSAGG 

Authorized  strength  aggregate  military 

98-102 

15 

AUSCIV 

Authorized  strength  civilian  (set  to  zero) 

103-107 

15 

3-24 


MOS-ENLISTED  FILE 
FILE  NUMBER  26 


CAA-D-84-2 


Record  Length:  42  characters 
Storage  Medium:  Mass  Storage 
Source  File:  8 

First  Use:  Output  from  Preprocessor,  Module  1. 1.2.1,  Separate  MOS  Data 


Name 

Description 

Position 

Format 

— 

Filler 

1 

A1 

UIC 

6-Dig:t  unit  identification  code 

2-7 

A6 

— 

Filler 

8-14 

A7 

GRADE 

Pay  grade 

15-16 

H  C 

CMF 

Career  Management  Field 

17-18 

A2 

MOS 

Military  occupational  specialty  code 

19-27 

A9 

— 

Filler 

28-31 

A4 

I  DENT 

Person  identity  code 

32 

Al 

REQSTR 

Required  (structure)  strength 

33-35 

13 

Authorized  strength 


AUTSTR 


36-38 


13 


MOS-OFFICER  FILE  FILE  NUMBER  27 


Record  Length:  42  characters 

Storage  Medium:  Mass  Storage  Source  File:  8 

First  Use:  Output  from  Preprocessor,  Module  1.1. 2.1,  Separate  MOS  Data 


Name 

Description 

Position 

— 

Filler 

1 

UIC 

6-Digit  unit  identification  code 

2-7 

— 

Filler 

8-14 

GRADE 

Pay  grade 

15-16 

CMF 

Career  Management  Field 

17-18 

MOS 

Specialty  code 

19-27 

— 

Filler 

28-31 

IDENT 

Person  identity  code 

32 

REQSTR 

Required  (structure)  strength 

33-35 

Authorized  strength 


AUTSTR 


36-38 


CAA-D-84-2 


MOS-WARRANT  OFFICER  FILE  FILE  NUMBER  28 

Record  Length:  42  characters 

Storage  Medium:  Mass  Storage  Source  File:  8 

First  Use:  Output  from  Preprocessor,  Module  1.1. 2.1,  Separate  MOS  Data 


Name 

Description 

Position 

Format 

-- 

Filler 

1 

A1 

UIC 

6-Oigit  unit  identification  code 

2-7 

A6 

— 

Filler 

8-14 

A7 

GRADE 

Pay  grade 

15-16 

A2 

CMF 

Career  Management  Field 

17-18 

A2 

MOS 

Specialty  code 

19-27 

A9 

— 

Filler 

28-31 

A4 

IDENT 

Person  identity  code 

32 

A1 

REQSTR 

Required  (structure)  strength 

33-35 

13 

AUTSTR 

Authorized  strength 

36-38 

13 

— 

Filler 

39-42 

A4 

3-27 


CAA-D-84-2 

MOS-DATA  (AGGREGATED  TO  3-DIGIT  UIC  LEVEL)  FILE 

FILE  NUMBER 

29 

Record  Length:  325  characters 

Storage  Medium:  Mass  Storage 

Source  File: 

:  26,  27,  28 

First  Use: 

Output  from  Preprocessor,  Module  1.1. 2. 2, 
UIC  level 

Roll  MOS  to 

3-digit 

Name 

Description 

Position 

For 

— 

Filler 

1 

A1 

UIC26 

Characters  2-6  of  UIC  (5  and  6  are  blank) 

2-6 

A5 

— 

Filler 

7-10 

A4 

CMF 

Career  management  field 

11-12 

A2 

MOS 

MOS 

13-21 

A9 

GRDGRP 

Grade  group;  repeats  16  items 

22-325 

(se 

GRDGRP  contains: 

bel 

GRADE 

E1-E9,  WO,  01-06 

(1-2) 

A2 

AS  I 

Additional  skill  identifier 

(3-4) 

A2 

LIC 

Language  identification  code 

(5-6) 

A2 

IDENT 

Person  identity  (M/F/0  &  grade) 

(7) 

A1 

REQSTR 

Required  (Structure)  strength 

(8-11) 

14 

AUTSTR 

Authorized  strength 

(12-15) 

14 

CAA-D-84-2 

MOS-DATA  (3-DISIT  WITH  ISSUE  CODE  ADDED)  FILE 
FILE  NUMBER  30 

Record  Length:  325  characters 
Storage  Medium:  Mass  Storage 
Source  File:  29 

First  Use:  Output  from  Preprocessor,  Module  1.2,  Set  ISSUE 


Name 

Description 

Position 

Format 

— 

Filler 

1 

Al 

UIC24 

Characters  2-4  of  UIC  (5  and  6  are  blank) 

2-6 

A5 

ISSUE 

ISSUE  code 

7-10 

A4 

CMF 

Career  management  field 

11-12 

A2 

MOS 

MOS 

13-21 

A9 

GRDGRP 

Grade  group;  repeats  16  items 

GRDGRP  contains: 

22-325 

(see 

below) 

GRADE 

E1-E9,  WO,  01-06 

(1-2) 

A2 

AS  I 

Additional  skill  identifier 

(3-4) 

A2 

LIC 

Language  identification  code 

(5-6) 

A2 

IDENT 

Person  identity  (M/F/0  &  grade) 

(7) 

Al 

REQSTR 

Required  (Structure)  strength 

(8-11) 

14 

AUTSTR 

Authorized  strength 

(12-15) 

14 

— 

Filler 

(16-19) 

14 

3-29 


MOS-DATA  (AGGREGATED  TO  ISSUE  LEVEL)  FILE 
FILE  NUMBER  31 

Record  Length:  325  characters 
Storage  Medium:  Mass  Storage 
Source  File:  30 

First  Use:  Output  from  Preprocessor,  Module  1.3,  Aggregate  MOS  data  to 
ISSUE  level 


Name 

Description 

Position 

Format 

— 

Filler 

1-6 

A6 

ISSUE 

ISSUE  code 

7-10 

A4 

CMF 

Career  management  field 

11-12 

A2 

MOS 

Specialty  code 

13-21 

A9 

GRDGRP 

Grade  group;  repeats  16  items 

GRDGRP  contains: 

22-389 

(see 

below) 

GRADE 

E1-E9,  WO,  01-06 

d-2) 

A2 

AS  I 

Additional  skill  identifier 

(3-4) 

A2 

LIC 

Language  identification  code 

(5-61 

A2 

IDENT 

Person  identity  (M/F/0  &  grade) 

•  (7) 

A1 

REQSTR 

Required  (Structure)  strength 

(8-13) 

16 

AUTSTR 

Authorized  strength 

(14-19) 

16 

— 

Filler 

(20-23) 

A4 

AGGREGATED  ISSUE  POLICY  FILE 
FILE  NUMBER  32 


CAA-D-84-2 


Record  Length:  80 
Storage  Medium:  Mass  Storage 
Source  File:  92 

First  Use:  Output  from  Policy  Processor,  Module  2.2A 


Name 

Description 

Position 

Format 

POLTYP 

Policy  type=' ISSUE' 

1-5 

A5 

=  sign 

6 

A1 

ISSUE 

ISSUE  code  of  '00'  level  only 

7-10 

A4 

II 

O 

11-13 

A3 

LOGRAD 

Lowest  grade  to  which  policy  applies 

14-15 

A2 

'  HI  = ' 

16-18 

A3 

HI GRAD 

Highest  grade  to  which  policy  applies 

19-20 

A2 

'AG=' 

21-23 

A3 

AGG 

'YES'  if  policy  is  to  aggregate 
'NO  '  if  policy  is  not  to  aggregate 

24-26 

A3 

_  _ 

' VALUE=* 

27-32 

A6 

VALUE 

Fill  value 

33-35 

13 

— 

Filler 

36-38 

A3 

•MIN= ' 

39-42 

A4 

PERMIN 

Minimum  percent  fill 

43-47 

F5.3 

'MAX=' 

48-51 

A4 

PERMAX 

Maximum  percent  fill 

52-56 

F5.3 

«... 

' M0S= ' 

57-60 

A4 

— 

Blank 

61-69 

A9 

-- 

Filler 

70-80 

All 

3-31 


^  v 


ISSUE  POLICY  FILE 
FILE  NUMBER  33 


Record  Length:  80 
Storage  Medium:  Mass  Storage 
Source  File:  92 

First  Use:  Output  from  Policy  Processor,  Module  2.2A 


Name 

Description 

Position 

Format 

POLTYP 

Policy  type=' ISSUE' 

1-5 

A5 

— 

=  sign 

6 

A1 

ISSUE 

ISSUE  code 

7-10 

A4 

1  L0=  * 

11-13 

A3 

LOGRAO 

Lowest  grade  to  which  policy  applies 

14-15 

A2 

— 

1  HI= 1 

16-18 

A3 

HI GRAD 

Highest  grade  to  which  policy  applies 

19-20 

A2 

-- 

'  AG= ' 

21-23 

A3 

AGG 

'YES'  if  policy  is  to  aggregate 
'NO  '  if  policy  is  not  to  aggregate 

24-26 

A3 

— 

'VALUE*' 

27-32 

A6 

VALUE 

Fill  value 

33-35 

13 

-- 

Filler 

36-38 

A3 

-- 

' MI N= ' 

39-42 

A4 

PERMIN 

Minimum  percent  fill 

43-47 

F5.3 

— 

'MAX*' 

48-51 

A4 

PERMAX 

Maximum  percent  fill 

52-56 

F5.3 

— 

'MOS*' 

57-60 

A4 

— 

Blank 

61-69 

A9 

— 

Filler 

70-80 

All 

CAA-D-84-2 

MOS  POLICY  FILE 
FILE  NUMBER  34 

Record  Length:  80 
Storage  Medium:  Mass  Storage 
Source  File:  92 

First  Use:  Output  from  Policy  Processor,  Module  2.2A 


Name 

Description 

Position 

Format 

POLTYP 

Policy  type='MOSSC‘ 

1-5 

A4 

=  sign 

6 

Al 

— 

Blank 

7-10 

A4 

'L0=' 

11-13 

A3 

LOGRAD 

Lowest  grade  to  which  policy  applies 

14-15 

A2 

_  _ 

'HI=' 

16-18 

A3 

HI GRAD 

Highest  grade  to  which  policy  applies 

19-20 

A2 

'AG=' 

21-23 

A3 

AGG 

'YES'  if  policy  is  to  aggregate 
'NO  '  if  policy  is  not  to  aggregate 

24-26 

A3 

'VALUE3' 

27-32 

A6 

VALUE 

Fill  value 

33-35 

13 

Filler 

36-38 

A3 

'MIN=' 

39-42 

A4 

PERMIN 

Minimum  percent  fill 

43-47 

F5.: 

„ 

'MAX=' 

48-51 

A4 

PERMAX 

Maximum  percent  fill 

52-56 

F5.: 

'M0S= ' 

57-60 

A4 

MOS 

MOS  or  specialty  code 

61-69 

A9 

CAA-D-84-2 

COMBINED  ISSUE  &  MOS  POLICY  FILE 
FILE  NUMBER  35 

Record  Length:  80 
Storage  Medium:  Mass  Storage 
Source  File:  92 

First  Use:  Output  from  Policy  Processor,  Module  2.2A,  Apply  Policies 
(Reread  as  input  to  same  module) 


Name 

Description 

Position 

Format 

POLTYP 

Policy  type=' ISSUE' 

1-5 

A5 

— 

=  sign 

6 

A1 

ISSUE 

ISSUE 

7-10 

A4 

-- 

■L0=' 

11-13 

A3 

LOGRAD 

Lowest  grade  to  which  policy  applies 

14-15 

A2 

-- 

*  HI=  ’ 

16-18 

A3 

HI GRAD 

Highest  grade  to  which  policy  applies 

19-20 

A2 

-- 

■AG=' 

21-23 

A3 

AGG 

'YES'  if  policy  is  to  aggregate 
'NO  '  if  policy  is  not  to  aggregate 

24-26 

A3 

— 

'VALUE*' 

27-32 

A6 

VALUE 

Fill  value 

33-35 

13 

-- 

Filler 

36-38 

A3 

' MIN= ' 

39-42 

A4 

PERMIN 

Minimum  percent  fill 

43-47 

F5.3 

— 

'MAX* ' 

48-51 

A4 

PERMAX 

Maximum  percent  fill 

52-56 

F5.3 

-- 

'M0S=' 

57-60 

A4 

MOS 

MOS  or  specialty  code 

61-69 

A9 

— 

Filler 

70-80 

All 

3-34 


CAA-D-84-2 

COMBINED  ISSUE  &  MOS  EXTRA  JOB  FILE 
FILE  NUMBER  36 

Record  Length:  325  characters 
Storage  Medium:  Mass  Storage 
Source  File:  31 

First  Use:  Output  from  Policy  Processor,  Module  2.2A,  Apply  Combined 
Policies 


Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name  (ISSUE  is  first 

4  characters) 

1-9 

A9 

— 

Filler 

10 

A1 

CMF 

Career  management  field 

11-12 

A2 

MOS 

Specialty  code 

13-21 

A9 

GRDGRP 

Grade  group;  repeats  16  items 

GRDGRP  contains: 

22-389 

(see 

below) 

GRADE 

E1-E9,  WO,  01-06 

(1-2) 

A2 

AS  I 

Additional  skill  identifier 

(3-4) 

A2 

LIC 

Language  identification  code 

(5-6) 

A2 

I  DENT 

Person  identity  (M/F/0  &  grade) 

(7) 

Al 

REQSTR 

Required  (Structure)  strength 

(8-13) 

16 

AUTSTR 

Authorized  strength 

(14-19) 

16 

CAA-D-84-2 

MOS  EXTRA  JOB  FILE 
FILE  NUMBER  37 

Record  Length:  325  characters 
Storage  Medium:  Mass  Storage 
Source  File:  36 

First  Use:  Output  from  Policy  Processor,  Module  2.2B,  Apply  MOS  Policies 


Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name  (ISSUE  is  first 

4  characters) 

1-9 

A9 

— 

Filler 

10 

A1 

CMF 

Career  management  field 

11-12 

A2 

MOS 

Specialty  code 

13-21 

A9 

GRDGRP 

Grade  group;  repeats  16  items 

GRDGRP  contains: 

22-389 

(see 

below) 

GRADE 

E1-E9,  WO,  01-06 

(1-2) 

A2 

AS  I 

Additional  skill  identifier 

(3-4) 

A2 

LIN 

Language  identification  code 

(5-6) 

A2 

IDENT 

Person  identity  (M/F/0  &  grade) 

(7) 

A1 

REQSTR 

Required  (Structure)  strength 

(8-13) 

16 

AUTSTR 

Authorized  strength 

(14-19) 

16 

-- 

Filler 

(20-23) 

A4 

3-36 


CAA-D-84-2 


ISSUE  EXTRA  JOB  FILE 
FILE  NUMBER  38 

Record  Length:  325  characters 
Storage  Medium:  Mass  Storage 


Source  File: 

37 

First  Use: 

Output  from  Policy  Processor,  Module  2..2C, 

Apply  ISSUE 

Policies 

Name 

Description 

Position 

Format 

OEMAN 

Demand  node  name  (ISSUE  is  first 

4  characters) 

1-9 

A9 

— 

Filler 

10 

A1 

CMF 

Career  management  field 

11-12 

A2 

MOS 

Specialty  code 

13-21 

A9 

GRDGRP 

Grade  group;  repeats  16  items 

22-389 

(see 

GRDGRP  contains: 

below) 

GRADE 

E1-E9,  WO,  01-06 

(1-2) 

A2 

AS  I 

Additional  skill  identifier 

(3-4) 

A2 

LIC 

Language  identification  code 

(5-6) 

A2 

IDENT 

Person  identity  (M/F/0  &  grade) 

(7) 

A1 

REQSTR 

Required  (Structure)  strength 

(8-13) 

16 

AUTSTR 

Authorized  strength 

(14-19) 

16 

— 

Filler 

(20-23) 

A4 

.  • 


3-37 


CAA-D-84-2 


JOB  ASSIGNMENT  VALUE  FILE 


1 

FILE  NUMBER 

39 

Record  Length:  452  characters 

.*■ 

Storage  Medium:  Mass  Storage 

Source  File: 

19,  32-35,  36-28 

■ 

First  Use: 

Output  from  Policy  Processor,  Module  2.2A, 

Apply  Combined 

■ 

Policies 

Name 

Description 

Position 

Format 

4 

DEMAN 

Demand  node  name  (ISSUE  is  first  4 
characters) 

1-9 

A9 

JMOS 

Job  MOS 

10-18 

A9 

i 

CMF 

Job  career  management  field 

19-20 

A2 

LOGRAD 

Lowest  grade  used  in  this  record 

21-22 

A2 

HI  GRAD 

Highest  grade  used  in  this  record 

23-24 

A2 

a 

AGGFIL 

Desired  aggregate  fill;  sum  of  GRAFIL 

25-30 

16 

AGGMIN 

Minimum  aggregate  fill 

31-36 

16 

AGGMAX 

Maximum  aggregate  fill 

37-42 

16 

i 

AGGVAL 

Value  of  filling  to  this  aggregate  level 

43-48 

16 

GRVAGR 

Grade  value  group  -  repeats  16  times 
Included  in  this  designation  are: 

49-452 

16(416) 

GRAFIL 

Desired  fill  for  this  grade  (I6)-may  be 

authorized  or 

structure 

> 

GRAMIN 

Minimum  fill  for  this  grade  (16) 

GRAMAX 

Maximum  fill  for  this  grade  (16) 

GRAVAL 

Value  of  fill  in  this  grade  (16) 

Vi 


> 


3-38 


■i  J  Jl 


Am 


CAA-D-84-2 

JOB  ASSIGNMENT  VALUE  FILE 
FILE  NUMBER  40 

Record  Length:  452  characters 
Storage  Medium:  Mass  Storage 
Source  File:  19,  32-35,  36-39 

First  Use:  Output  from  Policy  Processor,  Module  2.2B,  Apply  MOS  Policies 


Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name  (ISSUE  is  first  4 
characters) 

1-9 

A9 

JMOS 

Job  MOS 

10-18 

A9 

CMF 

Job  career  management  field 

19-20 

A2 

LOGRAD 

Lowest  grade  used  in  this  record 

21-22 

A2 

HIGRAD 

Highest  grade  used  in  this  record 

23-24 

A2 

AGGFIL 

Desired  aggregate  fill;  sum  of  GRAFIL 

25-30 

16 

AGGMIN 

Minimum  aggregate  fill 

31-36 

16 

AGGMAX 

Maximum  aggregate  fill 

37-42 

16 

AGGVAL 

Value  of  filling  to  this  aggregate  level 

43-48 

16 

GRVAGR 

Grade  value  group  -  repeats  16  times 
Included  in  this  designation  are: 

49-452 

16(416) 

GRAFIL 
GRAMIN 
GRAMA X 
GRAVAL 

Desired  fill  for  this  grade  (16) -may  be 
Minimum  fill  for  this  grade  (16) 

Maximum  fill  for  this  grade  (16) 

Value  of  fill  in  this  grade  (16) 

authorized  or 

structure 

CAA-D-84-2 


EXCESS  PEOPLE  {FROM  REGULAR  ASSIGNMENT)  FILE 
FILE  NUMBER  41 


Record  Length: 

Storage  Medium:  Mass  Storage 
Source  File:  2 


First  Use: 

Output  from  Assignment  Processor,  Subroutine 

PRENET  and 

PSTNET 

Name 

Description 

Position 

Format 

MOS 

MOS  or  specialty  code 

1-9 

A9 

NUMEXC 

Number  of  unassigned  people  by  grade 
(location  of  each  grade  is  that 
specified  by  Parameter  File) 

10-105 

16(16 

3-40 


CAA-D-84-2 


EXCESS  PEOPLE  (FROM  MOS  SUBSTITUTION)  FILE 
FILE  NUMBER  42 

Record  Length: 

Storage  Medium:  Mass  Storage 
Source  File:  2 


First  Use: 

Output  from  Substitute  Assignment  Processor, 
Substitution 

Module  4.2, 

MOS 

Name 

Description 

Position 

Format 

MOS 

MOS  or  specialty  code 

1-9 

A9 

NUMEXC 

Number  of  unassigned  people  by  grade 
(location  of  each  grade  is  that 
specified  by  Parameter  File) 

10-105 

16(16 

NUMEXC 


10-105  16(16) 


V — 


I 

CAA-D-84-2 

EXCESS  PEOPLE  (FROM  GRADE  SUBSTITUTION)  FILE 

FILE  NUMBER  43  | 

Record  Length: 

Storage  Medium:  Mass  Storage  / 

Source  File:  2 

First  Use:  Output  from  Substitute  Assignment  Processor,  Module  4.1,  Grade  I 

Substitution 


Name 

Description 

Position 

Format 

MOS 

MOS  or  specialty  code 

1-9 

A9 

» 

NUMEXC 

Number  of  unassigned  people  by  grade 
(location  of  each  grade  is  that 
specified  by  Parameter  File) 

10-105 

16(16) 

u. . 

I 


t 


I 


#  I 

3-42 


» 


EXCESS  PEOPLE  (SCRATCH)  FILE 
FILE  NUMBER  44 

Record  Length: 

Storage  Medium:  Mass  Storage 
Source  File:  2 

First  Use:  Scratch  file  for  Assignment  Processor 


Name 


Description 


Position 


MOS  MOS  or  specialty  code  1-9 

Number  of  unassigned  people  by  grade 
(location  of  each  grade  is  that 
specified  by  Parameter  File) 


Format 

A9 


NUMEXC 


10-105  16(16) 


►„* 

L-: 

i'. 

I;  CAA-D-84-2 

r  UNFILLED  JOBS  (FROM  POLICY  PROCESSOR)  FILE 

U  FILE  NUMBER  50 


Record  Length:  98  characters 
•\  Storage  Medium:  Mass  Storage 

Source  File:  38 


i 

First  Use: 

Output 

from  Policy  Processor,  Module  2.3, 

Set  Base  Values 

Name 

Description 

Position 

Format 

r 

DEMAN 

Demand 

(ISSUE 

node  name 

code  is  first  4  characters) 

1-9 

A9 

MOS 

MOS  or 

specialty  code 

10-18 

A9 

■ 

NUMUNF 

Number 

of  unfilled  jobs  by  grade 

19-114 

16(16) 

i 

i 


3-44 


CAA-D-84-2 

UNFILLED  JOBS  (FROM  REGULAR  ASSIGNMENT)  FILE 
FILE  NUMBER  51 

Record  Length:  98  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2,  40,  61 

First  Use:  Output  from  Assignment  Processor,  Subroutines  PRENET  and  PSTNET 


Name 

Description 

Position 

Format 

DEMAN 

Demand 

(ISSUE 

node  name 

code  is  first  4  characters) 

1-9 

A9 

MOS 

MOS  or 

specialty  code 

10-18 

A9 

NUMUNF 

Number 

of  unfilled  jobs  by  grade 

19-114 

16(16) 

UNFILLED  JOBS  (FROM  MOS  SUBSTITUTION)  FILE 
FILE  NUMBER  52 

Record  Length:  98  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2,  51,  53 

First  Use:  Output  from  Substitute  Assignment  Processor,  Module  4.2,  MOS 
Substitution 


Description  Position  Format 


Demand  node  name  1-9  /\g 

(ISSUE  code  is  first  4  characters) 

MOS  or  specialty  code  10-18  A9 

Number  of  unfilled  jobs  by  grade 


Name 

DEMAN 

MOS 


NUMUNF 


19-114  16(16) 


UNFILLED  JOBS  (FROM  GRADE  SUBSTITUTION)  FILE 
FILE  NUMBER  53 


CAA-D-84-2 


Record  Length:  98  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2,  51,  52 

First  Use:  Output  from  Substitute  Assignment  Processor,  Module  4.1,  Grade 
Substitution 


Name 

Description 

Position 

Format 

DEMAN 

Demand 

(ISSUE 

node  name 

code  is  first  4  characters) 

1-9 

A9 

MOS 

MOS  or 

specialty  code 

10-18 

A9 

NUMUNF 

Number 

of  unfilled  jobs  by  grade 

19-114 

16(16) 

CAA-D-84-2 


UNFILLED  JOBS  (SCRATCH)  FILE 
FILE  NUMBER  54 

Record  Length:  98  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2,  51,  52,  53 

First  Use:  Scratch  File  for  Substitute  Assignment  Processor 


Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name 

(ISSUE  code  is  first  4  characters) 

1-9 

A9 

MOS 

MOS  or  specialty  code 

10-18 

A9 

NUMUNF 

Number  of  unfilled  jobs  by  grade 

19-114 

16(16) 

3-48 


ASSIGNMENT  FROM  REGULAR  ASSIGNMENT  FILE 
FILE  NUMBER  61 

Record  Length:  43  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2 

First  Use:  Output  from  Assignment  Processor,  Subroutine  PSTNET 


Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name 

(ISSUE  code  is  first  4  characters) 

1-9 

A9 

— 

Filler 

10 

IX 

MOSREQ 

MOS  required  for  demand 

11-19 

A9 

-- 

Filler 

20 

IX 

MOSACT 

Actual  MOS  filling  demand 

21-29 

A9 

— 

Filler 

30 

IX 

GRDREQ 

Grade  required  for  demand 

31-32 

A2 

-- 

Filler 

33 

IX 

GRDACT 

Actual  grade  filling  demand 

34-35 

A2 

— 

Filler 

36 

IX 

Assigned  strength 


ASSSTR 


37-43 


17 


ASSIGNMENT  (FROM  MOS  SUBSTITUTION)  FILE 
FILE  NUMBER  62 

Record  Length:  43  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2 


First  Use: 

Output  from  Substitute  Assignment  Processor, 
Substition 

Module  4.2, 

MOS 

Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name 

(ISSUE  code  is  first  4  characters) 

1-9 

A9 

-- 

Filler 

10 

IX 

MOSREQ 

MOS  required  for  demand 

11-19 

A9 

— 

Filler 

20 

IX 

MOSACT 

Actual  MOS  filling  demand 

21-29 

A9 

-- 

Filler 

30 

IX 

GRDREQ 

Grade  required  for  demand 

31-32 

A2 

-- 

Filler 

33 

IX 

GRDACT 

Actual  grade  filling  demand 

34-35 

A2 

— 

Filler 

36 

IX 

Assigned  strength 


ASSSTR 


37-43 


17 


CAA-D-84-2 

ASSIGNMENT  (FROM  GRADE  SUBSTITUTION)  FILE 
FILE  NUMBER  63 

Record  Length:  43  characters 
Storage  Medium:  Mass  Storage 
Source  File:  2 


First  Use: 

Output  from  Substitute  Assignment  Processor, 
Substitution 

Module  4.1, 

Grade 

Name 

Description 

Position 

Format 

DEMAN 

Demand  node  name 

(ISSUE  code  is  first  4  characters) 

1-9 

A9 

-- 

Filler 

10 

IX 

MOSREQ 

MOS  required  for  demand 

11-19 

A9 

-- 

Filler 

20 

IX 

MOSACT 

Actual  MOS  filling  demand 

21-29 

A9 

-- 

Filler 

30 

IX 

GRDREQ 

Grade  required  for  demand 

31-32 

A2 

-- 

Filler 

33 

IX 

GRDACT 

Actual  grade  filling  demand 

34-35 

A2 

— 

Filler 

36 

IX 

Assigned  strength 


ASSSTR 


37-43 


17 


:  -  :<* 
• .  i 

CAA-D-84-2 

DETAILED  READINESS  INDICATORS  FILE 
FILE  NUMBER  64 

Record  Length:  68  characters  * 

Storage  Medium:  Mass  Storage  • 

Source  File:  61  >-v-\ 

First  Use:  Output  from  Readiness  Processor 


Name 

Description 

Position 

Format 

* 

ISSUE 

ISSUE  code 

1-4 

A4 

• 

•  ~ 

Filler 

5-10 

6X 

MOS 

MOS  required  for  demand 

11-19 

A9 

-- 

Filler 

20 

IX 

- 

• 

GRDREQ 

Grade  required  for  demand 

21-22 

A2 

REQSTR 

Required  (Structure)  strength 

23-28 

16 

AUTSTR 

Authorized  strength 

29-34 

16 

-  -k  •  -  u 

•  • 

ASSSTR 

Assigned  strength 

35-40 

16 

.  * 

AVASTR 

Available  people 

41-46 

16 

’  -v-;,  •' 

ASPEAU 

ASSSTR/AUTSTR*100 

47-53 

F7.1 

- . **-4 

• 

AVPEAU 

AVASTR/AUTSTR*100 

54-60 

F7.1 

AVPERE 

AVASTR/REQSTR*100 

61-67 

F7.1 

3-52 


1  Ul.  ■ 


*  *  i.  .  irn  i 


CAA-D-84-2 

DETAILED  READINESS  INDICATORS  USING  MOS  SUBSTITUTION  FILE 
FILE  NUMBER  65 

Record  Length:  67  characters 
Storage  Medium:  Mass  Storage 
Source  File:  62 

First  Use:  Output  from  Readiness  Processor 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

-- 

Filler 

5-10 

6X 

MOS 

MOS  required  for  demand 

11-19 

A9 

-- 

Filler 

20 

IX 

GRDREQ 

Grade  required  for  demand 

21-22 

A2 

REQSTR 

Required  (Structure)  strength 

23-28 

16 

AUTSTR 

Authorized  strength 

29-34 

16 

ASSSTR 

Assigned  strength 

35-40 

16 

AVASTR 

Available  people 

41-46 

16 

ASPEAU 

ASSSTR/AUTSTR*100 

47-53 

F7.1 

AVPEAU 

AVASTR/AUTSTR*100 

54-60 

F7.1 

AVPERE 

AVASTR/REQSTR*100 

61-67 

F7.1 

NOTE:  For 

File  65,  REQSTR,  AUTSTR,  ASPEAU, 

AVPEAU,  AVPERE  equal  zero; 

a 

matching  record  in  file  64  holds  these  data. 


CAA-D-84-2 

DETAILED  READINESS  INDICATORS  USING  GRADE  SUBSTITUTION  FILE 
FILE  NUMBER  66 

Record  Length:  67  characters 
Storage  Medium:  Mass  Storage 
Source  File:  63 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

-- 

Filler 

5-10 

6X 

MOS 

MOS  required  for  demand 

11-19 

A9 

-- 

Filler 

20 

IX 

GRDREQ 

Grade  required  for  demand 

21-22 

A2 

REQSTR 

Required  (Structure)  strength 

23-28 

16 

AUTSTR 

Authorized  strength 

29-34 

16 

ASSSTR 

Assigned  strength 

35-40 

16 

AVASTR 

Available  people 

41-46 

16 

ASPEAU 

ASSSTR/AUTSTR*100 

47-53 

F7.1 

AVPEAU 

AVASTR/AUTSTR*100 

54-60 

F7.1 

AVPERE 

AVASTR/REQSTR*100 

61-67 

F7.1 

NOTE:  For 

File  66,  REQSTR,  AUTSTR,  ASPEAU, 

AVPEAU,  AVPERE  equal  zero 

;  a 

matching  record  in  file  64  holds  these  data. 


3-54 


CAA-D-84-2 


TOTAL  RESULTS  INCLUDING  MOS  SUBSTITUTION  FILE  FILE  NUMBER  67 

Record  Length:  67  characters 
Storage  Medium:  Mass  Storage 
Source  File:  31,  61,  62 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

-- 

Filler 

5-10 

6X 

MOS 

MOS  required  for  demand 

11-19 

A9 

-- 

Filler 

20 

IX 

GRDREQ 

Grade  required  for  demand 

21-22 

A2 

REQSTR 

Required  (Structure)  strength 

23-28 

16 

AUTSTR 

Authorized  strength 

29-34 

16 

ASSSTR 

Assigned  strength 

35-40 

16 

AVASTR 

Available  people 

41-46 

16 

ASPEAU 

ASSSTR/AUTSTR*100 

47-53 

F7.1 

AVPEAU 

AVASTR/AUTSTRMOO 

54-60 

F7.1 

AVPERE 

AVASTR/REQSTR*100 

61-67 

F7.1 

NOTE:  This  file  is  equivalent  to  the  sum  of  file  61  and  file  62. 


CAA-D-84-2 


AGGREGATED  READINESS  INDICATOR  FILE 
FILE  NUMBER  70 

Record  Length:  128  characters 
Storage  Medium:  Mass  Storage 
Source  File:  31,  61,  62,  63 

First  Use:  Cjtput  from  Readiness  Processor 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

AGGREQ 

Aggregate  required  (structure)  strength 

5-10 

16 

AGGAUT 

Aggregate  authorized  strength 

11-16 

16 

AGGASS 

Aggregate  assigned  strength 

17-22 

16 

AGGAVA 

Aggregate  available  strength 

23-28 

16 

H5REAG 

High  5  required  (structure)  aggregate 

29-34 

16 

H5AUAG 

High  5  authorized  aggregate 

35-40 

16 

H5ASAG 

High  5  assigned  aggregate 

41-46 

16 

H5AVAG 

High  5  available  aggregate 

47-52 

16 

AGRESE 

Senior  grade  required  (structure)  aggregate 

53-58 

16 

AGAUSE 

Senior  grade  authorized  aggregate 

59-64 

16 

AGASSE 

Senior  grade  assigned  aggregate 

65-70 

16 

AGAVSE 

Senior  grade  available  aggregate 

71-76 

16 

AGREOK 

Correct  MOS  required  (structure)  aggregate 

77-82 

16 

AGAUOK 

Correct  MOS  authorized  aggregate 

83-88 

16 

AGASOK 

Correct  MOS  assigned  aggregate 

89-94 

16 

AGAVOK 

Correct  MOS  available  aggregate 

95-100 

16 

NUMPER 

MINPER*AGGAUT 

101-106 

16 

MISGOR 

NUMPER-AGGREQ 

107-112 

16 

MISGOA 

NUMPER-AGGAUT 

113-118 

16 

PERMIN 

PERMIN  from  base  Value  File 

119-122 

F4.2 

PERMAX 

PERMAX  from  base  Value  File 

123-126 

F4.2 

AGGREGATED  PERCENTAGE  AND  C-RATING  FILE 
FILE  NUM8ER  72 


Record  Length:  80  characters 
Storage  Medium:  Mass  Storage 
Source  File:  70 

First  Use:  Output  from  Readiness  Processor 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

-- 

Filler 

5 

A1 

Percentages 

REASPE 

(AGGASS/AGGREQ)*100 

6-12 

F7.1 

REAVPE 

( AGGAVA/AGGRE  Q ) *100 

13-19 

F7.1 

AUASPE 

(AGGASS/AGGAUT}*100 

20-26 

F7.1 

H5REPE 

(H5AVAG/H5REAG)*100 

27-33 

F7.1 

H5AUPE 

( H5ASAG/H5AUAG )*100 

34-40 

F7.1 

AVSEPE 

(AGAVSE/AGRESE)*100 

41-47 

F7.1 

ASSEPE 

( AGASSE/AGAUSE )*100 

48-54 

F7.1 

APREOK 

(AGAV0K/AGGREQ)*100 

55-61 

F7.1 

APAUOK 

( ASASOK/AGGAUT ) *100 

62-68 

F7.1 

C-ratinqs 

REAVC 

Based  on  REAVPE  (aggregate) 

69-70 

12 

REASC 

Based  on  REASPE  (aggregate) 

71-72 

12 

AUASC 

Based  on  AUASPE  (aggregate) 

73-74 

12 

AVSEC 

Based  on  ASEPE  (senior  grade) 

75-76 

12 

OKMOSC 

Based  on  APREOK  (correct  MOS) 

77-78 

12 

ISCRAT 

Overall  C-rating.  Based  on  lowest 
of  REAVC,  REASC,  AUSEC,  and  MOSC 

79-80 

12 

GRADE  READINESS  AND  PERCENTAGE  FILE 
FILE  NUMBER  73 

Record  Length:  44  characters 
Storage  Medium:  Mass  Storage 
Source  File:  64,  65,  66 

First  Use:  Output  from  Readiness  Processor 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

GRADE 

Grade  code 

5-6 

A2 

AGREGR 

Aggregate  required  (structure)  over  all  MOS 

7-12 

16 

AGAUGR 

Aggregate  authorized  over  all  MOS 

13-18 

16 

AGASGR 

Aggregate  assigned  over  all  MOS 

19-24 

16 

AGAVGR 

Aggregate  available  over  all  MOS 

25-30 

16 

PEREGR 

( AGA V  GR / AGRE  GR ) * 1 00 

31-37 

F7.1 

( AGASGR/AGAUGR )*100 


PEAUGR 


38-44 


F7.1 


CAA-D-84-2 

MOS  READINESS,  PERCENTAGE,  AND  C-RATING  FILE 
FILE  NUMBER  74 

Record  Length:  87  characters 
Storage  Medium:  Mass  Storage 
Source  File:  31,  61,  63 

First  Use:  Output  from  Readiness  Processor 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code 

1-4 

A4 

MOS 

MOS  or  specialty  code 

5-13 

A9 

— 

Filler 

14-15 

A2 

AGREMO 

Aggregate  required  (structure)  over  all 

grades 

16-21 

AGAUMO 

Aggregate  authorized  over  all  grades 

22-27 

16 

AGASMO 

Aggregate  assigned  over  all  grades 

28-33 

16 

AGAVMO 

Aggregate  available  over  all  grades 

34-39 

16 

MPERRE 

(AGAVM0/AGREM0)*100 

40-46 

F7.1 

MPERAU 

(AGASMO /AGAUMO) *100 

47-53 

F7.1 

H5REM0 

High  five  required  (structure) 

54-59 

16 

H5AUMO 

High  five  authorized 

60-65 

16 

H5ASMO 

High  five  assigned 

66-71 

16 

H5AVMO 

High  five  available 

72-77 

16 

C-i 

'■atings 

RMOSC 

Based  on  MPERRE 

78-79 

12 

AMO  SC 

Based  on  MPERAU 

80-81 

12 

CAA-D-84-2 

STRENGTH-BY-GRADE  PRINT  FILE 
FILE  NUMBER  85 

Record  Length:  Formated  for  printer,  maximum  length  =  132  characters 
Storage  Medium:  Mass  Storage 
Source  File:  30 

Fir.st  Use:  Output  from  Preprocessor,  Module  1.3,  Aggregate  MOS-data  to 


ISSUE  level 

Name  Description  Position  F 

Carriage  control  1 

ISSUE  ISSUE  code  2-5 

Filler  6 

AGGREQ  Aggregate  required  (structure)  strength  7-15 

AGGAUT  Aggregate  authorized  strength  16-24 

Filler 

GRADE  Pay  grade  or  rank,  E1-E9,  WO,  01-06  repeated 

AGREGR  Aggregate  required  (structure)  for  grade  as 

Aggregate  authorized  for  grade 


AGAUGR 


necessary 


CAA-D-84-2 


STRENGTH-BY-MOS  PRINT  FILE 
FILE  NUMBER  86 

Record  Length:  Formated  for  printer  -  maximum  length  =  132  characters 
Storage  Medium:  Mass  Storage 
Source  File:  30 

First  Use:  Output  from  Preprocessor,  Module  1.3,  Aggregate  MOS  data  to 
ISSUE  level 


ISSUE 


AGREMO 

AGAUMO 


Description 

Position 

Format 

Carriage  control 

1 

A1 

ISSUE  code 

2-5 

A4 

Filler 

6-8 

3X 

Career  Management  Field 

9-10 

A2 

Filler 

11-13 

3X 

Military  occupational  specialty 

14-22 

A9 

Filler 

23 

IX 

Aggregate  required  (structure)  for  MOS 

24-31 

112 

Aggregate  authorized  for  MOS 

32-40 

112 

AGGREGATED-ISSUE  INDICATOR  FILE 
FILE  NUMBER  90 

Record  Length:  405  characters 
Storage  Medium:  Mass  Storage 
Source  File:  32 

First  Use:  Output  from  Policy  Processor,  Module  2.2  A,  Apply  Combined 
Policies 


Name 

Description 

Position 

Format 

ISSUE 

ISSUE  code.  In  this  file, 
characters  2-3  =  00  and  character 

4  =  blank  or  - 

1-4 

A4 

AGIND 

Grade  aggregations  dimension  (16,  3) 

((1,0),  0=1,3),  I  =  1,8) 

(1.1)  =  low  grade 

(1.2)  =  high  grade 

(1.3)  =  value  of  assignment 

5-76 

24(13) 

AGPER 

Aggregate  percentages 

(1.1)  =  minimum  percent 

(1.2)  =  maximum  percent 

77-156 

16(F5.3) 

USEGRD 

Indicator  of  inclusion,  one  per  grade 
dimension  (16) 

157-172 

16(11) 

COMPUT 

Indicator  for  individual  grade  policy 
dimension  (16) 

173-188 

16(11) 

VALGRD 

Value  of  assignment  at  this  grade 
dimension  (16) 

189-284 

16(16) 

PERIND 

Percentages  for  each  grade  dimension  (16,  2) 

(1.1)  =  minimum  percentage 

(1.2)  =  maximum  percentage 

285-444 

32(F5.3) 

CAA- 

-D-84-2 

POLICY  FILE 

FILE  NUMBER  91 

Record  Length:  80  characters 

Storage  Medium:  Mass  Storage 

Source  File 

:  PFPRIM-FILES 

First  Use: 

Input  to  Policy  Processor,  Module  2.1, 

Edit  Policy  File 

Name 

Description 

Position 

Format 

POLTYP 

Policy  type.  One  of: 

'ISSUE' 

1-5 

A5 

•MOSSC.1 

— 

=  sign 

6 

Al 

ISSUE 

ISSUE  code 

7-10 

A4 

-- 

'  L0= ' 

11-13 

A3 

LOGRAD 

Lowest  grade  to  which  policy  applies 

14-15 

A2 

-- 

'  HI= 1 

16-18 

A3 

HI  GRAD 

Highest  grade  to  which  policy  applies 

19-20 

A2 

-- 

'AG= 1 

21-23 

A3 

AGG 

‘YES'  if  policy  is  to  aggregate 
'NO  '  if  policy  is  not  to  aggregate 

24-26 

A3 

— 

'VALUE*' 

27-32 

A6 

VALUE 

Fill  value 

33-35 

13 

-- 

Filler 

36-38 

A3 

-- 

'MIN-' 

39-42 

A4 

PERMIN 

Minimum  percent  fill 

43-47 

F5.3 

' MAX* ' 

48-51 

A4 

PERMAX 

Maximum  percent  fill 

52-56 

F5.3 

' MOS* ' 

57-60 

A4 

MOS 

MOS  or  specialty  code 

61-69 

A9 

-- 

Filler 

70-80 

All 

CAA-D-84-2 

EDITED  POLICY  FILE 
FILE  NUMBER  92 

Record  Length:  80  characters 
Storage  Medium:  Mass  Storage 
Source  File:  91 

First  Use:  Output  from  Policy  Processor,  Module  2.1,  Edit  Policy 

Name  Description  Position 


POLTYP  _ 

Policy  type.  One  of: 

'ISSUE1 

'MOSSC1 

1-5 

— 

=  sign 

6 

ISSUE 

ISSUE  code 

7-10 

-- 

1  L0= ' 

11-13 

LOGRAD 

Lowest  grade  to  which  policy  applies 

14-15 

— 

1 H I  =  * 

16-18 

HI  GRAD 

Highest  grade  to  which  policy  applies 

1  AG= 1 

19-20 

— 

21-23 

AGG 

'YES'  if  policy  is  to  aggregate 
'NO  1  if  policy  is  not  to  aggregate 

24-26 

— 

' VALUE= ' 

27-32 

VALUE 

Fill  value 

33-35 

— 

Filler 

36-38 

-- 

' MIN= ' 

39-42 

PERMIN 

Minimum  percent  fill 

43-47 

— 

' MAX= ' 

48-51 

PERMAX 

Maximum  percent  fill 

52-56 

— 

' M0S= ' 

57-60 

MOS 

MOS  or  specialty  code 

61-69 

— 

Filler 

70-80 

CAA-D-84-2 


REPORT  REQUEST  FILE 
FILE  NUMBER  93 

Record  Length: 

Storage  Medium:  Mass  Storage 
Source  File:  PFPRIM-FILES 

First  Use:  Input  to  Report  Processor 


Name 

Description 

Position 

Format 

REPNUM 

Report  number 

1-2 

A2 

— 

Filler 

3 

A1 

YES/NO 

'Yes'  or  'no' 

4-6 

A3 

-- 

Filler 

7 

A1 

WHICH 

Report  type:  'MOS',  'All',  'ORIGINAL', 

,  'MOS  SUB',  'Grade  Sub',  or  ISSUE  code 
when  report  number  is  03,  08,  10,  or  11; 
WHICH=blank  when  report  number  is  01,  02, 
04,  05,  06,  07  or  09 

8-19 

A12 

— 

Filler 

20 

A1 

REPNAM 

Report  name 

21-81 

A61 

*Please  refer  to  section  2.4.6  and  Appendix  C,  section  5  for  a  full 
description  on  the  use  of  this  file. 


.  • 
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SECTION  4 

PROGRAM  MAINTENANCE  PROCEDURES 


4.1  CONVENTIONS 

4.1.1  Process  Numbering  Conventions.  Process  numbers  have  been  assigned 

|  to  all  main  programs  and  subroutines  which  perform  a  function  described  in 

the  PRIM  Functional  Description  (CAA-D-84-1) .  Typically,  these  numbered 
programs  are  called  upon  to  perform  the  stated  function  one  time  during  a 
complete  set  of  model  executions.  If  the  numbered  program  is  a  subroutine, 
it  will  be  called  by  one  main  program  or  by  one  subroutine  that  is  higher 
in  the  hierarchical  organization,  and  will  never  be  called  by  any  other 
j  program.  Subroutines  that  have  not  been  assigned  a  process  number  are 

utility-type  subroutines  that  perform  a  function  that  is  required  by  the 
program  design  but  which  is  transparent  to  the  user.  These  subroutines  are 
usually  called  by  more  than  one  main  program  or  subroutine,  and  some  are 
called  by  programs  in  more  than  one  processor.  The  subroutines  that  are 
called  by  multiple  programs,  but  within  one  processor  only,  are  described 
i  in  alphabetical  order  in  the  section  that  describe  that  processor. 

Subroutines  that  are  used  by  more  than  one  processor  are  described  in 
Section  2.10,  PRIM  Utility  Program  Descriptions. 

a.  Translating  The  Process  Number.  Each  PRIM  process  has  been  assigned 

_  an  integer  number  in  the  range  of  one  to  six  which  represents  the  order  of 

I  %  •  that  process  in  the  sequential  processing  (see  Table  4.1).  The  next  digits 

represent  the  module  or  subroutine  order  in  the  processing  order  within  the 
process.  The  individual  process  digits  are  described  below: 

•  First  digit  The  process  number. 

B  •  Second  digit  The  integer  represented  by  statements  in  the 

Functional  Description  such  as  first,  second, 
and  third.  When  this  digit  is  zero,  there 
are  no  other  main  programs  for  the  processor. 

•  Third  digit  A  subsequence  number  representing  the  logical 

*  order  in  which  this  self-contained  sub¬ 

function  should  be  processed.  When  not 
present,  there  were  not  multiple  sub¬ 
functions. 

a  Fourth  digit  If  present,  this  digit  represents  the  logical 

sequence  within  the  hierarchy  represented  by 
the  first  three  digits. 
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fa.  Example  of  Process  Number:  In  the  process  number  1.2.3: 


1  represents  the  processor.  Preprocessor, 

2  represents  the  second  function  of  the  Preprocessor  "Set  the  Issue 
code"  described  in  the  Functional  Description, 

3  represents  the  third  method  of  setting  the  ISSUE  code,  "Set  the 
ISSUE  based  on  ASGMT  code." 


Table  4-1.  PRIM  Process 


Process 

order 

Process 

name 

1 

Preprocessor 

2 

Policy  Processor 

3 

Assignment  Processor 

4 

Substitute  Assignment  Processor 

5 

Readiness  Processor 

6 

Report  Processor 

4.1.2  File  Name  Conventions.  File  names  are  assigned  as  follows  (note 
that  file  names  may  be  12  or  fewer  characters): 


Character  1-2 


PF,  which  represents  the  Force  Plans  division 
at  MILPERCEN. 


Character  3-10 


Character  11-12 

(or  last  two  characters) 


Mnmemonic  for  the  type  of  data  contained  in 
the  file.  When  possible,  the  entire  word  is 
used  as  in  PFISSUE14  and  PFP0LICY91. 
Otherwise,  mnemonics  are  the  first  one  to 
three  characters  of  the  words  that  describe 
it,  such  as  PFAGISP032  (aggregated-ISSUE 
policy). 

File  number  used  in  program  and  for  which 
an  @USE  statement  wil  be  needed  in  the 
runstream. 
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I 

I 


I 
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4.1.3  Data  Element  Names.  Data  elements  have  the  same  name  in  all  files 
(see  Appendix  A,  Data  Dictionary).  In  general,  all  programs  use  these  same 
names.  However,  when  the  same  element  must  be  read  from  more  than  one  file 
for  comparison  or  for  addition,  a  variation  on  the  same  name  is  used  which 
changes  the  first  or  last  character. 

4.2.  VERIFICATION  PROCEDURES 

a.  The  processors  which  are  most  likely  to  require  future  modifications 
are  the  Preprocessor  and  the  Policy  Processor.  Most  of  the  programs  in 
these  processors  contain  print  statements  that  are  executed  or  not  based  on 
the  value  of  a  variable  called  IDEBUG.  The  larger  the  I  DEBUG  value  is  set, 
the  more  debug  print  is  produced.  The  programer  may  trace  all  the  proces¬ 
sing  of  input  data,  the  parameter  values,  and  the  process  interactions  by 
running  the  program  with  the  debug  flag  set  to  its  maximum  value  or  trace 
certain  areas  by  selectively  setting  it.  A  table  ordered  by  program  name 
which  shows  the  debug  flag  settings  that  affect  each  program  will  be  found 
in  Table  4-2,  Debug  Flag  Settings  by  Program  Name.  TabTe  4-3,  Debug  Flags 
by  Process  shows  the  valid  debug  flags  for  each  process. 

b.  The  debug  flag  in  process  1.2,  Set  ISSUE  Code  controls  whether  the 
output  file  of  MOS-data  will  be  written.  When  the  flag  is  set  to  nine  (9) 
or  greater  and  the  number  of  serious  errors  is  greater  than  zero,  the  ISSUE 
code  is  not  set  in  the  MOS-data  and  the  output  file  is  not  written.  This 
option  allows  the  user  to  begin  testing  the  ISSUE  definitions  prior  to 
completion  of  process  1.1.2,  Roll  MOS-data  to  three-digit  UIC  level. 

c.  The  Report  Processor  is  designed  as  a  main  program  (DRIVE6)  which 
reads  the  report  requests  and  calls  the  appropriate  subroutine.  A  dif¬ 
ferent  formatted  report  is  produced  by  each  subroutine.  This  processor 
can  be  easily  modified  by  adding  a  report  number  to  the  Report  Request 
file,  file  number  93  and  adding  an  additional  call  to  the  end  of  program 
DRIVE6,  or  by  replacing  a  report  subroutine  with  a  different  subroutine. 

d.  The  Assignment  Processors  and  the  Readiness  Processor  are  not  likely 
to  require  modification  and  no  special  procedures  have  been  developed  for 
verification  of  future  modifications. 
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Table  4-3.  Debug  Flag  Settings  by  Process 


Flags 


1/8 

2/9 

3/10 

4/11 

5/12 

6/13 

l.i.i 

3 

9 

1 

r  '  1 

i 

j 

1.2 

6 

9 

10 

15  * 

l 

u 

1.2.1 

5 

11 

46 

49 

52 

55 

88 

92 

95 

98 

1.2.2 

5 

11 

43 

84 

85 

86 

i 

1.2.3 

5 

11 

31 

34 

37 

40 

69 

J 

71 

72 

74 

75 

78 

79 

1 

1.2.4 

5 

19 

98 

] 

1.2.5 

5 

65 

66 

1 

1.3 

1 

2 

6 

10 

20 

30 

2.1 

1 

8 

2.2.1 

2 

11 

2.2.2 

1 

2.2.3 

7 

2 

2.2.4  thru  2.2. 

2 

3 

4 

5 

6 

7 

8 

11 

' 

2.3 

2 

3 

4 

5 

8 

11 

4.3  ERROR  CONDITIONS 

The  majority  of  the  errors  are  found  by  the  programs  that  read  and 
reformat  the  user-provided  files.  These  programs  are  in  the  Preprocessor 
and  Policy  Processor.  Errors  identified  by  these  processors  are  written  to 
file  13  which  is  defined  as  an  alternate  print  file.  The  errors  can  be 
sent  to  the  printer  with  the  @SYM  command,  printed  on  a  local  printer  with 
the  @ED  command,  or  scanned  from  the  demand  terminal.  A  complete  listing 
of  the  error  messages,  and  a  description  of  the  reason  for  each  error  and 
the  action  taken  by  the  program  will  be  found  is  Appendix  E.  Table  4-4 
associates  an  error  number  with  the  programs  which  write  that  error. 

Errors  originating  from  the  computer  operating  system  should  be  handled  in 
accordance  with  standard  operations  procedures. 
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Table  4-4.  Error  Numbers  and  Programs 


From  Programs 


Message 

or 

Error 


0 

DRIV12 

DRIVE13 

DRIVE  2/2-A 

DRIVE2/2-8 

DRIVE2/2-C 

DRIVE2/3 

APP22A 

APP22B 

1 

SETTPS 

SETUIC 

2 

ROLMOS 

3 

SETBAS 

4 

R0LM0S 

5 

SETASG 

SETMOS 

6 

SETUIC 

7 

SETTPS 

ISSFIN 

SETUIC 

SETASG 

9 

ISSUNA 

10 

EDIPOL 

11 

EDIPOL 

12 

EDIPOL 

13 

EDIPOL 

SETPOL 

14 

EDIPOL 

15 

EDIPOL 

16 

EDIPOL 

17 

EDIPOL 

18 

EDIPOL 

19 

EDIPOL 

20 

EDIPOL 

21 

EDIPOL 

22 

EDIPOL 

MAKAGG 

SETPOL 

23 

GETBAS 

24 

GETBAS 

25 

GETBAS 

26 

GETBAS 

SETBAS 

30 

ROLMOS 

AGGMOS 

EDIPOL 

GETPAR 

SETPOL 

32 

ROLMOS 

AGGMOS 

PAR 

37 

EDIPOL 

GETPAR 

39 

ROLMOS 

EDIPOL 

GETPAR 

40 

ROLMOS 

AGGMOS 

GETPAR 

41 

GETPAR 

42 

ROLMOS 

SRTPOL 

43 

SETUIC 

44 

SETPQL 

45 

MAKAGG 

46 

EDIPOL 

SETPOL 

61 

GETBAS 

62 

GETBAS 

7C 

AGGMOS 

71 

AGGMOS 

97 

NXTISS 

98 

AGGMOS 

GETJOB 

EDIPOL 

GETPAR 

AGISPO 

99 

AGGMOS 

EDIPOL 

GETPAR 

SRTPOL 

AGISPO 

GETBAS 

GETJOB 

GETPOL 

MATPOL 

WRTEXT 

WRTUNF 

WRTVAL 

103 

SETTPS 

SETUIC 

125 

GETJOB 

126 

ROLMOS 
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4.4  SPECIAL  MAINTENANCE  PROCEDURES 


a.  Executive  Control  Language  (ECL) 

The  ECL  associated  with  each  of  the  16  runstreams  used  to  run  the  6 
processors  is  shown  in  Figures  4-1  through  4-16.  Although  there  are  only 
14  different  modules,  there  are  two  extra  runstreams  for  the  Substitute 
Assignment  Processor;  one  for  performing  grade  substitution  first,  and  one 
for  performing  MOS  substitution  first. 

b.  Compile  and  Mapping  Procedures 

The  commands  used  to  compile  and  map  the  symbolic  elements  into 
absolute  elements  are  shown  in  Figure  4-17  through  4-30.  Prior  to  any  of 
these  runs,  the  PRIM  utility  programs  should  be  compiled  using  the  commands 
shown  in  Figure  4-31. 

4.5  SPECIAL  MAINTENANCE  PROCEDURES 

a.  Program  File  Assignment 

The  files  that  will  be  needed  to  recreate  the  PRIM  system  from  a  tape 
backup  may  be  created  with  the  commands  shown  in  Figure  4-32. 

b.  Data  File  Assignment 

The  data  files  that  will  be  needed  can  be  created  using  one  runstream 
that  creates  the  files  needed  by  the  first  processor  (Figure  4-33),  another 
that  creates  the  files  needed  by  the  next  processor  (Figure  4-34),  and  a 
final  runstream  that  creates  the  files  needed  for  the  Assignment  Processor 
through  the  Report  Processor  (Figure  4-35). 

4.6  LISTINGS 

The  program  listings,  including  symbolics,  absolutes,  and  ECL  are 
resident  in  the  MILPERCEN  system  libraries. 
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a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a  . 
a  . 

■  <UG,A 
ausE 
a  . 
a  . 
a  . 

a A  SG  t  A 

aERS 

ausE 

fefe* 

axoT 

l 

a  • 
aE  hee 
8free 


*»****«ee**o*«**********a*«»«*«« 

AGGREGATE  THE  UIC  DATA  |F ROM  "HEADER  RECORD")  TO  3-OIGIT  LEVFL 
THE  PUNSTREAH  for  CREATING  THE  EXECUTABLE  ELEMENT  IS: 

08  PRIM-MAP .30 1 UIC/ 1-1-1 

»**•**£***«********«************ 

-  -  -  ASSIGN  THE  6-DIGIT  UIC  FILE  INPUT 


PF  UIC  60  IG  22  • 

22  .  .PFUIC60IG22 . 

■  -  ASSIGN  THE  3-DIGIT  UIC  FILE 

PF  UIC  3D  IG  23  • 

PFuIC  3D IG  23 • 

23.,PfOIC30IG23. 

PFPRIM-ABS. 

PFPRIM-AB  S. 

PFPRIM-ABS.755R0LUIC/1-1-I 


PFUIC6DIG22. 
PFuIC  3D IG  23 • 


OUTPUT 


Figure  4-1.  ROLUIC/1-1-1  Runstream 


■f> 


•  9 
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9 


,'k  .  S- 
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£  .  FI  PS  T  SORT  TH£  FILE  ON  THE  FIRST  4  CHARACTERS  OF  THE  HOS  WITHIN 

3  . 

3  .  CHARACTER  2-4  OF  UIC.  I.t.  UlC  CHARACTER  2,  I  L  4  IS  THE  H  A  JCR 

i  ’  SORT  AND  CHARACTER  i  THROUGH  4  OF  HOS  IS  THE  MINOR  SORT 


a  a  s  c ,  a 

PFINPUTM0S8  . 

guse  a. 

.PFINPUTMOSB  . 

iASG.T 

XA ..///1CCC 

iASG.T 

xb  ,,///n:co 

i  • 

iSORT.ES 

F I lE I N-8 • 
FILEOUTrfa 

• 

kEY  =  J,3,S 
KEY=19,4, 
RS2 - 1 32 

•  A 

S ,  A 

RE  C0PD-27P 

jEOF 
a  • 
iFREE 

X  A  • 

iFREE 

xB  . 

iF  PEE 

PFINPUTM0S8. 

a  • 

i  «  -  -  - 
i  4  SG  t  A 

PFERR0R13. 

output 

iERS 

PFERR0R13. 

<2  . 

»A  SG  »  A 

PFPARAMEH7  . 

INPUT 

«  A  SC  *  A 

pfinputmosb  . 

INPUT 

5  • 

a  A  S  G  «  A 

PFMOS-ENL-26. 

.  output 

Jasg.a 

PFMOS -OFF-27, 

.  OUTPUT 

i  A  S  G  ,  A 

PFMOS-WO-28. 

.  OUTPUT 

a  . 

i A  SG , A 

PF  MO  SO  A  TA  29  . 

OUTPUT 

INPUT  -  PARAMETER  file  (MAIN) 

INPUT  -  FIRST  INPUT  OF  HOS  DATA 
OUTPUT  -  USED  TO  TEMPORARILY  holO  ENLISTEC 

OUTPUT  -  USED  TO  TEMPORARILY  HOLD  OFFICER 

OUTPUT  -  USED  TO  TEMPORARILY  HOLD  WO 


UIC  LEVEL  -  MOS  HAS  ALSO  BEEN 
ROLLED  AS  SPECIFIED  By  THE 
PARAMETER  FILE 


■  USE 

13..PFERR0R13. 

•  < 

iUSE 

17..PFPARAMET17 . 

.  -1 

iUSE 

fa  ..PFINPUTMOSB  . 

.  J 

iUSE 

26  ., PFMOS-ENL-26. 

*  V 

ause 

27  ..PFMOS-OFF-2  7. 

iUSE 

28 ., PF mo S-WO-28  . 

iUSE 

29..PFM0S0ATA29. 

"■  * 

«  • 

*  • 

ERASE  THE  ERROR-PRINT  FILE  ANO  THE 

INPUT 

PARAMETER  file 

i  • 

•  ERS 

13. 

*1 

•  ERS 

17. 

_  -1 

d  • 
i  * 

MOVE  THE  PARAMETER  FILE  INTO  FILE 

17  FOR 

USE  NOW 

i ASG  *  A 

PFPRIM-FILES. 

■*  M 

*ed 

PFPR  IM-FILES.PARAMETER.17. 

EXIT 

"  -  A 

iFREE 

PFPRIM-FILES. 

a  • 

SASC  t A 

a  • 

iFREE 

iXQT 
«  « 
iEO.R 
P  » 


EXECUTE  The  programs  -  this  program  HAS  NO  DEBUG  FLAG 
INOTE:  this  IS  A  set  OF  TWO  SEQUENTIAL  PROGRAMS) 

I  FILE  B  IS  INPUT  TO  "SEPARATE",  OUTPUT  FILES! 

(  ARE  26,  27,  and  28.  THESE  ARE  THE  MAIN  INPUT) 

!  TO  “ROLHOS*  and  FILE  29  IS  THE  OUTPUT) 


TO  “ROLHOS"  and  file  29  I 
PFPOIM-ABS, 

PFPRIM-A8S. 

PFPRIM -A BS. 755 SEPARATE/ 1-1-2  A 
PFEPROR13. 


PFPRIM-AB S.7S SR OLMOS/ 1-1-2 

AFTER  MOVING  TO  MILPERCEN  THE  FOLLOWING  STATE “ENTS  SHOULD  BE 
REPLACED  WITH  a  SYM  OF  FILE  IT  TO  THE  MILPERCEN  PRINTER 


iEO.R  II. 
LNP  r 
£  X  I 
iFREE 
iF  kEE 
*FREE 
iFREE 
iF  REE 
i  FREE 
iFREE 


PF£ RRORlI. 
PFPARAMET  IT  . 
PF INPUTM0S8  . 
PF  “0  S-ENL  -2  o  • 
PF“OS-OFF-27. 
PF “C S-WO-28  . 
PFM0S0ATA29  . 


Figure  4-2.  ROLM0S/1-1-2  Runstream 
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a  .  PRIOR  RUNSTREaM:  POLMOS/l-l-2 

a  • 

a  .  NEXT  RUNSTREAM:  AGGMOS/l-3 

a  . 

a  ■  -  -  -  -  __________  -  -  -  - 

a  . 

a  .  SORT  THE  MOS  0 ATA  FILE  WHICH  HAS  SEEM  ROLLED  ON  MOS  TO  3-OIGIT  LEVEL 

a  .*  SORT  FEY  IS  THE  3-OIGIT  UIC 

a  • 

3ASG.A  PFM0SDATA29. 

aUSE  29 ..PFMOSOAT  A  29 • 
aASG.T  XA..///1C0C 

3ASG.T  XB..///1CCCO 

aSORT ,ES 
FILEIN=29. 

FILE0UTI29. 
kEY  =  2,3,S,A 
KEY  =  13,9,S,  A 
RS2R32S .CHARACTERS 

3  .  SENSITIVITY  TEST  FILE  IS  SHALL  -  NOT  NEEDED  REC0R0=9G 

aE  of 

aFREE  XA. 

sfree  xb. 

3FREE  29. 

a, - - - - .... - 

a  . 

a  .  ASSIGN  THE  FILES  NEEDED  for  “SETISSUE”,  PROCESSOR  1-2 

a  • 

a.  ------------------  ERASE  THE  ERROR  PRINT  FILE 

3ASG.A  PFFRRORII. 

aERS  PFERROR 13. 

a  -  -  -  -  -  -  -  -  -  -  -  -  HOVE  THE  LATEST  COPY  OF  ISSUE 

a  .  into  the  file  for  use 

3ASG.A  PF IS  SUE  19 • 

a!oS  PF  PR  Ih^IlE  ISSUE, PFISSUE  IN. 

EXI 

a  ................  hove  the  latest  copy  of  paraheter 

a  .  INTO  THE  file  FOR  USE 

GASG.A  PFPAPAMET1T. 

aERS  PFPARAHET17. 

RED  PFPRIH-FILES.PARAHETER,PFPAflAH£TI7. 

EX  I 

a  .  INPUT  -  23  IS  THE  UIC  FILE  ROLLED  TO  3-OIGIT  UIC 

a  .  this  file  was  an  output  file  from  the 

a  .  run  “ROLuic/i-i-i" 

aASG.A  PFUIC3DIG23. 
a  . 

a  .  OUTPUT  -  29  l  25  -  WORK  FILES  USED  FOR  UIC  WITH 

a  .  ISSUE  ADDED.  EITHER  ONE  “AY  3£ 

a  .  the  final  output,  the  program 

a  .  .  IDENTIFIES  THE  FINAL  OUTPUT  FILE. 

aASG.A  PFUICDATA24. 
aASG.A  PFUICOATA25. 

a  INPUT  -  2<j  -  THE  MOS  DATA  ROLLED  TO  3-DIGIT  UIC  AND  TO 

a  .  THE  NUMBER  OF  characters  OF  MOS  SPECIFIED 

a  .  IN  THE  PARAMETER  file  117) 

aASG.A  PFM0S0ATA29. 

a  . 

a  .  OUTPUT  -  3C  -  THE  MOS  OAT*  WITH  ISSUE  CODE  ADDED 

a  .  THIS  file  MUST  BE  SORTED  ON  ISSUE  and 

a  .  MOS  PRIOR  TO  RUNNING  THE  NEXT  PROCESSOR 

aASG.A  PF  “0  SOAT  A  3  D  . 

a.  .........  JTTACH  LOGICAL  UNIT  NUMBERS  ILUN)  TO  THE  FILES 

aUSE  I3..PFEPPORI3. 
ausr  14..PFIS5UE14  . 

RUSE  23  ..PFUIC30IG23  . 
ausc  24 ..PFUICQATA24 . 
aUSE  2S ..PFUICDATA2S . 
aUSE  29..PFMOSDATA29  • 
aust  3C..PFMOSOATA3C. 

<3  • 

a  .  ---------  ASSIGN  SONS  TEMPORARY  SCRATCH  FILES 

i  • 

£ As  G  *  T  XA.,///2C0 

sasg.t  xe.#///i60c 

3  • 

iFRrr  PFPRIM-ABS. 

■  X  **  T  *  F  PFPOlH-A8S.7S5?ETlSSUE/l-2 

1-OEBL'G  FLAG 

aED,R  13* 

LNP  • 

Cxi 

•  SYH,U  P  F£  PR  OR  1 3  » 

dFREE  PFEPP0R13. 

■  FPFE  PFISSUE1**. 

5F«E£  3 FP AP  AH£Tl 7. 

«FREE  PFUIC  :0IG73. 

iFREE  PFUIC0ATA24. 

■  FREE  PFUIC0ATA2E. 

iFREE  PFM0S0ATA29. 

•FREE  PFMOSOATATC. 

•FREE  *A. 

■free  XB. 
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Figure  4-3.  SETISSUE/1-2  Runstream 


1 


A 


CAA-D-84-2 


Q 


I 


i 

i 


j  . . sour  THE  INPUT  MOS  PILE  BY  ISSUE  AND  MOS 

3  . 

a  ASO.A  PF  HO  SO  A  T  A  30  • 

a  . 

SASG.T  XA..///1000 
SASG.T  XP..///11000 

aSORT.ES  #**  FILE  HUST  be  SORTED!  •** 

FILEIN=PFM0S0ATA30. 

FILEOUTrPFMOSOA  TA30. 

KEYr7,R ,S,A 
KF Y:13,9,S, A 
afor 

a  . 

3F  REE  PF  MO  SO  A  T  A  30  • 

3FREE  XA. 

3FREE  Xb. 
a 

a  . 

a,  _____  assign  the  error  print  file 

a  . 

BAS  G  »  AX  PFERR0R13. 

BERS  PF  ERROR 1 3 • 

a  . 

a . . assign  the  parameter  file 

a  . 

BASGtA  PF  PA  RAME  T 17  • 

aEO.R  PFPRIH-FILES.PARAMETER.PFPARAMET 17. 

a  # 

g  . . INPUT  -  MOS  DATA  AT  3-DIGIT  UIC  LEVEL 

BAsG.A  PFM0SDATA3D. 

a  . 

a  . . OUTPUT  -  MOS  OATA  AGGREGATED  TO  ISSUE  LEVEL 

a  ■ 

a A  SG  .  A  PFM0SISSUE3  1. 

a  . 

a  .  .  OUTPUT  -  ISSUE  AGGREGATES  t  GRADE  AGGREGATES 

a  . 

BASG.A  PFGRASTREN85. 

a  -  OUTPUT  -  MOS  AGGREGATES  BY  ISSUE 

a  . 

BASG.A  PFM0SSTREN86. 

a  . 

BUSE  13..PFER  ROR 13. 
auSE  17..PFPARAMET17 . 
aUSE  30..PFM0S0ATA30. 

BUSE  31..PFMOSISSUE3 1. 
auSE  8S..PFGRASTREN85. 

BUSE  8b.,PFM0S5tREN86. 
aXCT.F  PFPRIM-ABS.755AGGM0S/1-3 
1 -DEBUG  FLAG 
BE  D  .R  13. 

LNP  * 

EX  I 

BF  REE  PFM0S0ATA3D. 

3FREE  PFERROR-S-13  . 

BFREE  PEPARAHET17. 

BFREE  PFMOS  ISSUE  31  . 

BF  REE  PFGRASTREN85 . 

iF  REE  PFM0SSTREN86  . 


Figure  4-4.  AGGMOS/1-3  Runstream 


CAA-D-84-2 


!phPWh-SK 

gPFPRIM-ABS 

S*SG.» 

aERS 

S»sn,» 

aco 

EX  1 

Sa  £g,a 

aco 

EX  i 

a  . 

ax  sg.a 

aco 

EXI 

SasG.A 


POl/2-1 
. TITLE, 0 
. TITLE, 0 

PFFRRQR13. 
ERROR  13, 


di  ?J 


IT  POLICY  FILE 
.POLICY, ,2S-S1 
EDIT, POLICY, 

-----  ASSIGN  THE  ERROR  PRINT  FILE 


PFEF 

ASSIGN  THE  ISSUE  FILE 

PFISSUE1R. 

PFPRIM-FILES.ISSUE.PFISSUE 14. 

-------  assign  the  parameter  file 

PFPARAHE  T 1 7 , 

PFPRIM-FILES.PARAMETER,PFPARAMET17. 

-------  ASSIGN  THE  POLICY  FILE 

FFPOLICY91. 

PFPRIH-FILES.P0LICY.PFP0LICY91. 

-------  ASSIGN  THE  OUTPUT  POLICY  FILE 


ausc 

13. .PFERR0R13. 

ausc 

19.  .PFISSUEII . 

ausc 

17..PFPARAMET17 

ausc 

91.  .PFP0LICY9 1 • 

ausE 

92. .PFEDIP0L92. 

a  . 

iASG.T 

X  A  .  ,  /  /  /  100 

a  A  SG  ,  T 

XB..///1000 
PFPR IH-A8S. 7S5F0 
G  F  L  A  C 

axoT 

2-0  E  B  U 
8E0.R  13. 
LNP? 

EXI 

ASSIGN  TEMPORARY  FILES  FOR  SORTING  POLICY  FILE 


aED.R  92. 
LNP  • 

5*REE  13. 
GFREE  19. 
8FREE  17. 
iF REE  91. 
8F RE E  92. 
iF  RE E  XA. 

sfree  xb. 


*  »- 

9 


Figure  4-5.  EDIT-POLICY/2-1  Runstream 


•  • 
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iHCG  APPLyPOLICY/2-2-*  APPLY  POLICIES  TO  "OS 
iPFPSIM-APS.TITLL.C  APPLY, POLICY,  .  2  -2/  » 

iP,P3IH-ApS. TITLE. 0  APPLY, POLICY, -2 /A 

!  i  THIS  IS  PROCESS 

i  '  THIS  RUHSTREAH  IS  POP  PART  A  OP 


oaTa,  part  a 


2  -  2  -  A  (PART  A  OP  apply  POL  ICY  > 
THE  apply  POLICY  PROCESS  (2.2/AI 


apply  POLICY  PROCESS  ■ A S  SPOKEN  INTO  SEVERAL  PARTS  TO  “LL0«  ThE 

USES  HOPE  PlEX  tatLlTY  .  WHEN  c.  OR  OR  S  ARE  P  OUNO  ?Y  ONE  OF  THE  LATE  = 

f  1 1 P  B  o  j  T  T  wF  S  IT  *S  NOT  NECESSARILY  RFQuiRED  THAT  ALL  PARTS  APE 

REPEATED.  .hen  THE  ?-'.IcWlLE  IS  CH  A  n4eO  ,.  A  S  A  RE  ?P0  N  S  E  ,  TO  £  PROP  S 

'DEfcTIPirn  ay  p  as?  T  B*  THE  EDIT  POLICY  MOOULc.  iPROCEiS  3.1) 

at  RERUN,  The  USER  CAN  DO  SO  IMMEDIATELY  BATHER  THAN  WAIT  POP  ALL  THE 

-5ESI  Of  THE  PROCC  SSOP  TO  RUN  TO  COMPLETION  • 


SORT 


DATA 


m 

I  2  > 


a  . 

a  . 

iASG. A 


THIS  PILE  IS  An  OUTPUT  PROM  1-3 


PfMOSISSUE31 . 


XA  •  ,///MaO 

xb .,///i9ao 


aASG.T 
a  A  j  G  t  T 

a  . 

aSOPT.ES 

FILEIN-PF»0SISSUE31. 
f rLTOUTrprwoS ISSUE  3 1 
*E  r:7  t*  fs  . A 
kE v=I3,R,StA 
■  EOF 


iF  BEE 

•  free 

iFRES 


PFM0SISSUE3 1# 

X  A  • 

XB  . 


a  •  **  - 
"a 1g« a 

PFE  BROR 1 3 • 

•E  R  S 

PFERR0R1 3. 

•  A  SC  .a 

PFPlRAMETl 7. 

•E  □ 

PFPRIH -FILES. PAR AHtTER, 

E*  I 

a  .  -  - 

iASG.  A 

PFEDIP0L92 . 

a  • 

a  .  -  - 
a  • 

also. a 

PFHOSISSUE  31 . 

a  .  -  - 

•  A  SG  •  A 

«E  a  s 

a  . 

PF I  SHOE*  36  . 

PFISHOEX36  . 

a  • 

i  A  S  G  *  A 

PFAGISP032  . 

iASG. A 

PFISSPOL33  ■ 

PFM0SP0L34  . 

•  A  SG  ,  A 
aA  sg,a 

P F I $MOPQ  35  . 

PFAGISIN09C. 

as  as 
a  . 

PFAGISIN09G. 

iA SG  »  A 

PFJOBASVAL  39  . 

•  E  a  S 

PF JOBASVAL  39  . 

Iusr 

1 3.  *  PF  E  RROfi l 3 . 

ausE 

17.  .PFPiRAMETl 7. 

ausE 

3  1.  .PFmoSISSUE  31  . 

32.  .PF AGISPO  32  . 

«U  iF 

33. ,PFISSPOL33  . 

•  USE 

3<*.  ,PFmoSPOL3<*  . 

•  USE 

35. ,PF I SMOPO  JS  . 

-USE 

3ft.  .PFISHOEX  36  . 

ausr 

3*.  .PFJOBASVAL  39  . 

•  USE 

9»*.  .PFAGISIND9  0. 

•  USE 

•  • 

>2.  .PFEDIP0L92  . 

a  • 

iASG*  T 

xa  .,///2i3 

•  A  SG  *  T 

x 0  . ,  ///  14C 

i  X  C  T  ,  F 

PFPBIM-48S.75SAPPP0L/2- 

e  >t  G  FLAG 

SE  S.B 

PFE  RR0R1 3. 

w 

•  F  ^  E  E 

I  3  . 

mf  ~rt 

IT. 

iif.fr 

J  l  . 

iF-FE 

32  . 

»F  £ 

3  3. 

iF  -FE 

3u. 

*F  * F E 

3  t  • 

•  F  ,  i.  t 

3  b  . 

ft  F  m  f  i 

3  9  . 

iFwr  E 

?c. 

•  F  H,rF 

9  2. 

if;fr. 

X  A  . 

•  F  n  £  i 

i  B  . 

ASSIGN  THE  ERROR  OUTPUT  PRINT  FILE 


ASSIGN  THE  PARAMETER  FILE 
»FPARAMET17. 

ASSIGN  the  policy  file  -  - 

THIS  FILE  IS  An  OUTPUT  FROM  2-1 

ASSIGN  the  INPUT  JOB  file  -  -  - 
THIS  FILE  IS  an  OUTPUT  FROM  1-3 
SORTED  NOW  ON  ISSUE  ANO  HOS 

ASSIGN  the  extra  job  file  -  -  - 
ASSIGN  THE  OUTPUT  POLICY  FILES 


input 


-  INPUT 
ANO  IS 


OUTPUT 


ASSIGN  THE  OUTPUT  JAW  FILE 


-  -  -  OUTPUT 


ASSIGN  TEMPORARY  FILE  FCR  POLICY  SORT 


Figure  4-6.  APPLY-P0LICY/2-2-A 
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Ei 


I 


t 


S  l* 


SHOO  AP  °L  YPCL  IC  Y  /  2  “2  “C  APPLY  POLICIES  to  MOS  DATA,  P‘Rt  c 
iPFPRIM-APS.TITLE.u  »PPLT,  POLICY,,  2*?-C 
iPFPRIM-APS. title, 0  APPLY.P0LICY..2-2-C 

*  ;  T  M  r  s  !  s  process  2.2.6  (part  c  or  apply  policyi 

i  IMIS  3  UN  STREAM  IS  FO®  PART  C  OF  THE  APPLY  POLICY  PROCESS  12-2-0 

*  *  APPLY  POLICY  PPCCESS  vAS  BROKEN  INTO  S EVE R AL  P *R T S  T 0  ALLOW  THE 

*•  •  N^£Essipu°;sR^SiPEDN?H:TY 

S  :  ic?n*i^cc  S?eSA5?cc:°Vftivc61'iERi£ig^SSS«Scc*5»ftogciS0|t5.TSuir0,*s 

I  i  OF  POLICIES1  USE 3  ?N  ^T^eTsE^A^eMJVo  PART  C 

i  .  lO  continue  processing. 

i  . .  •  • 

‘  ] . S  0  »  I  NOS  DATA  ON: 

II  ISSUEONLY 

I  *  THIS  FILE  IS  BN  OUTPUT  FROM  2-2B 

Iasg.a  pfmosext  J7. 

a  a  so, i  xa  ..///soo, 

•  A  S6i <  *8  •  t ///28C0 

a  . 

■  SO*7T,£S 

FlLSI*>P*“OStXT37. 

FT  LCGUT -PF^OSEX  T  3  7 • 

KEt=  l  *S  .A 

•  E  a>F 

iFREE  PFMOSEXT3T. 

■FREE  XA. 

•free  xe. 

j  I  .  ASSIGN  THE  ERROR  OUTPUT  PRINT  FILE 

iASG.A  PFERRORI3. 

jE*s.  ...  pferrorii.^  ASSIGN  THE  PARAMETER  FILE 

AASG.A  PFPARAMET17.  ... 

iED  PPPRIM-FILES.PAHAMETER.PFPARAMET17. 

fXI  .........  -  ....  assign  the  issue  policy  file,  -  *  *  input 

I  •  this  file  IS  an  OUTPUT  FROM  2-2  A 

A  A  SG , A  PFISSPOL33. 

?  assign  the  input  job  file  -  -  -  -  input 

?  *  THIS  file  IS  an  output  from  2-23 

?  *  ANO  SHOULD  HAVE  BEEN  SORTED  ON  ISSUE 

5  *  8Y  THE  time  this  POINT  IS  REACHED 

iASr,,A  PFHOSEX  T  37  . 

?;.....  _  .....  -  ASSIGN  THE  EXTRA  JOB  FILE  -  -  -  -  OUTPUT 

•  A  SC  ,  a  PFISSEXT38. 

iERS  PFISSEXT38. 

1  ■ . ASSIGN  THE  INPUT  JAV  FILE  -  -  -  -  INPUT 

„  ]  THIS  file  IS  AN  OUTPUT  FROM  2-2B 

•ASH, A  PFJ0BASVAL8C. 

2  J.  ASSIGN  THE  OUTPUT  JAV  FILE  -  -  -  -  OUTPUT 

iASG.A  PFJOBASVAL 39. 

iERS  PF JOBASV AL 39 . 

S  •  .  _  .....  _  ...  —  assign  the  aggregated  indicator  file 

2  •  THIS  FILE  IS  AN  OUTPUT  FROM  2-2A 

iASG.A  PFAGISIN090. 

|  J.  ........  -  -  -  -  DEFINE  THE  FILE  NUMBERS 

■USE  II. .PFERROR13. 

OUSE  l’.  .PFPARAMETJ7. 

•  USE  33.  .PFlSSPOl  33. 

•  USE  !?. .PFMOSEXT37  . 

•  USE  38.  .PFISSEXTI8  . 

■  USF  39.  ,pF J06AJVAL39. 

iusf  **  r  •  .pfjobasvalao. 

iUSE  9C. .PFAGISINOOC. 

I  \  ASSIGN  TEMPORARY  files  fop  policy  sort 

a  ! 

i A  S  G  ,  T  XA..///1C 

•  aSg.i  xe.,///7o 

iXCT.F  PFPRIM-A8S  . 75 S APPPOLV 2 - 2'C 

r-0  E  8  U  G  FLAG 

iED.R  PFERROR13. 

LNP  ’ 

EX  I 

•FREE  12. 

•free  it. 

•free  33. 

•FREE  37. 

iFSEE  38. 

SFrEE  39. 

•FrEE  VC. 

•  FREE  9  L • 

•  free  xa. 

•FREE  x6. 

Figure  4-8.  APPLY-POLICY/2-2-C  Runstream 
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ASSIGNEE  NT/3 
PFPRIM- 


SH  QG 
SASG.A 

S  . 

SASG.A 
SASG.A 
SEO.U 
EX  I 

SASG.A 
SASG.A 
SEO 
EX  I 

SASG.A 
SASG.A 
SASG.A 
SaSG.a 
SASG.A 
SASG.T 
SASG.T 
SASG.T 
SASG.T 
SASG.T 
S 

s  » 

SASG.T 
SASG.T 

SSORT.ES 
PILEIN-PFNUMSPE0P21. 
FILEOUT=PFNUMBPEOP21  . 
KEY-9.9.S.A 
SEND 

SSORT.ES 

FIlEINRPF J0BASVAL40. 

FlLE0UT-PrJ0BASVAL4C. 

KET:10,9,S,A 

KEY=1,8.S,A 

SEND 

XA. 

XP  • 


A8  S. 


ASSIGNMENT  PROCESSOR  3  0 


PFPRIM-FILES. 

PFISSUE11*. 

PFPPJM-FXLES. ISSUE,  PF I SSUE  14  • 
PFNETINI5. 

PFPARAMETl 7. 

PFPRIM -FILES. PARA METER ,PF PARAPET  17. 

PFNUHBPEOP  21 . 

PFJ0BASVAL4C. 

PFE  XCPE0P4  1.///SQC0 
PFUNFILLEDS1.///5C00 
PFASSIGNED61.///5CC0 
PFNET0UT2, ///CGCQ 
PFNETuORKJ  ,///5CQC 
PFNETUORk  4 ,///5CGC 
PFNETWCRK8  .///scar 
PFNETW0RK9  ,///5000 


xa  .,///2aoQ 

XB  ..///llQOD 


SORT  THE  INPUT  FILES 


SORTED  8 Y  HOS 


SORTED  BY  HOS 


SORTED  BY  OEHAND  NAME 


SFrEE 

SFREE 

s  « 

SUSF 

SUSE 

SUSE 

SUSE 

SUSE 

SUSE 

SUSE 

SUSE 

SUSE 

SUSE 

SERS 

SUSE 

SERS 

SUSE 

SERS 

SXOT 


2.  ,PFnET0UT2. 

3. .PFNETU0RK3  . 

4.  , PF  NE  T WORK  4  . 

9.  .PFNETW0RK9  . 
in. .PFTSSUE14. 

15. . PFNETIN15. 

17. . PFPARAMETl 7. 

21. . PFNUMBPE0P21. 

4  C . .PFJ0BASYAL40. 

41.  ,PFE  XCPE0P4  1. 

4  1. 

51. . PFUNFILLED51. 

51. 

61. . PFASSIGNE061. 
b  1 . 

PFPRIM -ABS.7SS ASSIGN/ 3 

SEO.R  41. 

LNP  • 

SASG.A  PFUNF ILLED5C. 

SEO.U  51. 

AOO  PFUNF ILLED50. 

LNP  • 

SEO.R  bl. 

LNP  • 

OH  1 


ASSIGN  REST  OF  FILES 


SASG.T  XA..///I1CC 
SASC-.T  XB..///12000 
SSORT.ES 

FILE1NRPFEXCPE0P41. 

FILE0UTRPFEXCPE0P41. 

4EY:1,9,S,A 

SEND 

SEO.U  PFUNF ILLED  5 1 

ADD  PFUNF ILLECSO. 

EX  I 

SSORT.ES 

FTLEIN-PFUNFILLED5 1. 
FILE0UT-PFJNFILLE051  . 
APYriG.R.S, A 
KEY=I,6,j,A 
SENO 

SSORT.ES 

FTLEINRPF 4SSIGNED61. 
FILEOUT-PFASSIGNEDbl. 
KEYri.n.S . A 
SEND 

SFpEE  41. 

SFPEE  SI. 

SFrEE  bl. 


SORT  THE  OUTPUT  FILES 


SORTED  BY  HOS 


ORTED 
“TED 


?  OR 


BY  «oS 

BY  DEMAND  NAME 


SORTED  PY  JOB’S  FIRST  4  CHARACTERS 


Figure  4-10.  ASSIGNMENTS/3  Runstream 
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SSjr.T  PFNETOUT2..///1000 
5A$r,T  PF  NE  TW  OR  K  3  • 

SASC.T  PFNETW0RK4. 

SASG.T  PFNETW0RK8. 

SASC,T  PF  ME  TW0RK9 • 
iASG.A  PFNE TIN15..///2000 


SASC.A  PF IS  SUE  14. 
i  E  0  PFPRIM-FIL 

EXI 


assign  network  working  files 


ISSUE  r ILr 


PF  PR  IM-F  ILES. IS  SUE, PE IS  SUE  14  . 

-----------  PARAMETER  file 


S  A  S  C-  »  A  PF PARA  ME  T17  . 

SED  PFPRIM-FILES.PARAME7ES,PFPARAMET17. 
EXI 

SASG.A  PFNUMBPE0P21. 

5 A  SG  ,  A  PF J0BASVAL40. 

5ASG.A  PFEXCPE0P4I, 
iA  SC, 4  PF  EX  PEOGRA43 • 


5  .  A  S  G  ,  A  PFUNF ILLE05C  , 

S  A  S  G  »  A  PF  UN FILLE051. 

SASG.A  PFUNFILLGR53. 

SAST.A  PFA SSIGNGR63. 
aERS  PFA SS  IGNGR63  . 

SUSE  2  ..PFNET0UT2  . 

SU  S r  3  .  .PFNETWORK 3. 

SUSE  4  .  ,PFNE TWORK 4 . 

SUSE  6  .  .PFNETWORK 8. 

SUsE  9  .  ,  PF  NE  T  WORK  9 • 

SUSE  14  .  ,PF ISSUE  14  . 

SUir  ;S  ..PFNETIN15 . 

SUSE  *7 . ,PF PARAMET 17. 

SUSE  21.,  PFNUMBPE0P2I 

SUSr  4£  ., PF J03ASVAL4G. 

SUSE  41  ..PFEXCPE0P41, 

SUSE  43  ..PFExPEOGR A43. 

SU$r  El  .,PFUNFTLLED51. 

SUSE  r 3  .  ,  PFUNFILLGR53. 

SUSE  63  .  ,PF ASSIGNGR63. 

SXST  PFPRIM-ABS.7S5SUBST-6R0/4-1 

SFREE  PFNET0UT2. 

SFrEE  PFNETWORK3. 

SFREE  PF  NE  I W  OR  K  4 • 

SFrEE  PF  NE T W  OR K 9 . 

SE0,R  43. 

P  f 

SED,R  53. 

P  ? 

SE  D  ,R  63. 

P  • 

jM  SC  ,N 

S  A  sG , T  XJ.,///20Q0 
SASC,T  XP.,///10QGO 
SSOPT ,ES 

FILEIN=PFEXPE0GRA43. 
FILE0UT-PF£XPE0GRA43  • 

KEY-1, 9, S, A 
SE  NO 

SSOPT ,ES 

FILEIN=PFUNFILLGR53. 

F  I  LEOUT-PFUNF ILLGR53  . 

KEY- IQ, 9, S, A 
KEY- 1 ,9 ,S ,A 
SE  NO 

SSOPT  ,ES 

FILEINPPF  ASSIGN GR63. 
FILE0UTPPFASSIGNGR63. 

KE  y: 1 , 4  ,S  ,A 
KEY-lU,9fS, A 
SE  NO 

SFREE  XA. 

SFREE  XF. 

SFREE  43. 

SFREE  S3. 

SFrEE  63. 


ADD  UNFILLED  JOBS  FROM  POLICY  PPQCESSOR 


.  SCRATCH  FILE,  INPUT  TO  MODEL 
.  PARAMETER  FILE 

.  CONTAINS  NUMBER  OF  PEOPLE  PY  MOS 
.  INPUT  JOB  FILE 

.  INPUT  EXCESS  PEOPLE  FILF  BY  MOS 
.  OUTPUT  EXCESS  PEOPL  FILE  BY  GRADE 
.  INPUT  EXCESS  JOB  FILE  BY  JOB 
.  OUTPUT  UNFILLED  JOB  FILE  -  GRADE 
.  OUTPUT  JOB  ASSIGNMENT  FILE 


Figure  4-11.  SUBST-GRD1ST/4-1  Runstream 


3  -----------  ASSIGN  NETWORK  WOPKING  FILES 

a  A  SO  ,  T  PFNE  TOUT2.  ,///lCDO 
olSSr.T  PFNETWOPK3. 

3ASF-T  PFNETU0RK4. 

3ASG,T  PFNETUORKo. 
aaSF.T  PFNETW0RK9. 

|A SC » T  PFNETI«15. _ .  .  is5UE  F1LE 

i  ASC.A  PFPR  1M-F  ILES. 
a  A  SG  *  A  PF IS  SUE  1  9  . 

PFPRIM-FILES.ISSUE.PFISSUE14. 


PARAMETER  FILE 


iJEO 
EX  I 

a  .  -  -  -  ;  - 

a A  SG  , A  PF  PA  RAME  T17  .  _  .  „ 

aru  PFPR IM-FILES.PARAMFTER.PFPARAMETI7. 
EX  I 

ar-s'EE  PFPR  IM -F  ILE  S  . 
a  A  SO  >  A  PF  JO  8  A  S  V  AL  4  L  • 
a A  SG  «  A  PFFXCPEOP41. 
a  A  SG  t  A  PFEXPE0M0S42. 

3ASC,T  PF  EX  PE  OK  OS 4  4 • 


S  A  S  G  »  A  PFuNFILLEDSC. 

3  A  SG  t  A  PF  UN  F  I  LL  CO  5  1  . 

3  A  SG  ,  A  PF  UN  F  I  LL  MO  E  2  . 

3 A  SG  ,  T  PFUNFILLE054  . 

PFASSIGNM062. 

2  .  ,PF  NE TOUT2  . 

3  .  .PFNETWORK3. 

4  .  ,PFNETWORK4. 

5  .  ,PF NET  WORK  8. 

9 . , PF NETWORK  9  . 

14  .  ,PF ISSUE  14  . 

15  .  t  PF  NE  T  IN  1  5  . 

17  .  .PFPARAMET  17. 

21. »  PFPRIM21 
4M,,PF  J0BASVAL4G. 

41 .  ,  PF  EX  CPE  OP  4  1  . 

42 . .PFEXPEOMOS42  . 

44  ..PFEXPE0M0S44 . 

C1  .  ,  F  F  UNF ILLEDS1. 

5  2.,  PFyNF ILLM052 . 

54  .  .PFUNFILLED54 . 

62  .  ,  PF  ASS IGNM062  « 

PFPR  IM-ABS. 

...  .....  PFPR  IM-ABS. 
aXQT  PFPR IM-ABS .755SUBST-M0S/4-2 
aFRFE  PFNE  TOUT  2. 

PFNETU0PK3. 

PFNE  TUORK4 . 

PFNE  TU0RK9 . 

42. 
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3ASC,A 

ausr 
au  se 
au  se 
ausE 
ausE 
ausr 
ausE 
ause 
ausF 
£USr 

au  sf 
ausr 
au  se 
ausr 
ausr 

au  sr 
a  A  SG  ,  A 
£F  R  EE 


SCRATCH  FILE,  INPUT  TO  MODEL 
PAPAMETER  FILE 

CONTAINS  NUMBER  OF  PEOPLr  BY  MOS 
INPUT  JOB  FILE 

INPUT  EXCESS  PEOPLE  FILE  BY  MOS 
OUTPUT  EXCESS  PEOPL  FILl  By  MOS 
SCRATCH  EXCESS  PEOPL  FILE  By  MOS 
INPUT  EXCESS  JOB  FILE  BY  JOB 
OUTPUT  EXCESS  JOB  FILE  BY  JOB 
SCRATCH  EXCESS  PEOPL  FILE  BY  MOS 
OUTPUT  JOB  ASSIGNMENT  FILE 


SFhEE 
aF  PEE 
3F  k  E  E 

aro  »r 

p  • 

3E  O  ,  R  52. 

P  • 


aEO.R  62. 

P  * 

a A  SG  ,  T  X  A . ,  /  // 2QOD 
o A  SG  ,  T  XF.  ,///  100DD 
asoPT  ,ES 

F ILr IN=PFEXPEOMOS42  . 
FI LEOUT=PrE  XPE0M0S42  • 
K  E  Y-  1 , 9  »S  » A 
ac  no 

asoPT  ,ES 

FlLrIN=PFUNFlLLM052. 
FI  lEOUT-PFUNF  ILLM052  • 
KE Y=10,9,S, A 
SEND 


asoPT,  ES 

FILEIN  =  PF  ASSIGN  MO 62. 
FILE0UT=PFASSIGNM062. 
KEY-1, 4, S,A 

a  e  n  r 

iFK-.C  XA. 

£  E  REE  X  F  . 


Figure  4-12.  SUBST-MOS1ST/4-2  Runstream 
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3  ,  —  —  —  —  —  - 

3  A  SC  ,  A  PFME T0UT2. ,///lCOO 
3  A  SG  *  T  PENETW0RK3. 

SASG.T  PF  N£  T  W  OR  K4  • 
a  A  SG  f  T  PFNETW0RK8. 
a  A  SG  t  T  PFMETW0RK9. 

3  A  SG  »  A  PFNETIN15. 


a.  -----------  ISSUE  FILE 

a  A  SG  »  A  PF IS  SUE  14. 

3EU  PF  PR IM -FILES. IS  SUE ,PF ISSUE  14  . 

EX  I 

a.  ___________  parameter  file 

aAS^.A  PFPARAMET17. 

uED  PF  PR IM -FILES. PARAMETER ,PFPArAmET17. 

EX  I 


a  A  S  G  ,  A  PF  JOBASV AL40. 
aAsr.A  PF  Fx  PE  0M0S42 . 
i A  S  0  t  A  PFEX PE0GRA43. 
aASC.A  PFUNFILLM0S2. 

3A  SG , A  PFUNFILLGR53. 
a  A  S  G  »  A  PF  AS  S I GNGR6  3 • 
auSF  2  . * PFNET 0UT2  • 

aUSE  •  3 . .PFNETWORK 3  . 
iUSC  4 •  , PF  NE  TWORK  4  , 

oust  6 . .PFNETWORK 8 . 

3USr  9 . .PFNETW0RK9. 

2USF  !4  .  .PFISSUE 14  . 

ausr  15  . , PFNE  T IN  15  • 

OUSE  17 . , PFPARAMET  17. 

3USr  21.,  P  FNUMB  PE  OP2 1 

3USE  4n.,PFJ08ASVAL40. 

OUSE  42 ..PFEXPE0M0S42. 

ausr  43 ..PFEXPEOGR A43. 

3USE  52.,  PFUNFILLM052. 

3USE  53.,  PFUNF ILLGR53 . 

au^E  63 . , PF ASSIGNGR63. 

axCT  PFNET. 755SUBST-GRO/4-1 
uF  REE  PFNETOUT2. 

3FREE  PFNETW0RK3. 
a F  R E E  PF  NE  Tw  OR  K4  , 
a  F  r  E  E  PFNETW0RK9. 
i  E  Li ,  P  4  3. 


INPUT  EXCESS  PEOPLE  FILE 
OUTPUT  EXCESS  PEOPLE  FILE 
INPUT  UNFILLED  JOB  FILE 
OUTPUT  UNFILLED  JOB  FILE 


.  SCRATCH  FILE,  INPUT  TO  MODEL 
.  PARAMETER  FILE 

.  CONTAINS  NUMBER  OF  PEOPLE  BY  MOS 
.  INPUT  JOB  FILE 

.  OUTPUT  EXCESS  PEOPL  FILE  BY  MOS 
.  OUTPUT  EXCESS  PEOPL  FILE  BY  GRAD 
.  OUTPUT  EXCESS  JOB  FILE  By  JOB 
.  OUTPUT  UNFILLED  JOB  FILE  -  GRADE 
.  OUTPUT  JOB  ASSIGNMENT  FILE 


P  ’ 


3ED,R  53. 
p  r 

3  l  0  ,  K  63. 

P  • 

uASr,T  XA.,///2u00 
a  A  SG , T  x  P • » / / / 10QG0 
aSOFT  ,ES 

FILEIN=PFEXPE0GRA43. 
FIlE0UT=PFEXPE0GRA43. 
KEY-1, 9, S, A 
ar  nd 

3S0PT  ,ES 

FILEIN=PFUNFILLGRS3. 
FILE0UT=PFUNFILLGR53. 
KE Y=10f9,S, A 
KEY-1, 9, S, A 

a  e  nd 

asuRT ,ES 

FILEIN=PFASSIGNGR63. 
FILF0UT=PFASSIGNGR63. 
KE  y:  1 ,4  ,S  ,A 
SEND 

a  F  R  E  E  XA. 
mEhEE  XP. 
cF  REE  4  3. 

OFREE  53. 

3  F  r  E  E  63. 
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Figure  4-13.  SUBST-GRD2ND/4-1  Runstream 
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£  4  SC  ,  A 
»*  SC  ,  T 
£  A  s  C-  ,  T 
6f  A  S  G  *  T 
£4  SC-  ,  T 
a  A SG  ,  A 
a  • 

SASG.A 
i  r  D 
EX  I 
£  • 
tii  A  SG  «  A 
£  E  0 
EX  I 

£A  SC-  ,  A 
£4  SG  ,  A 

A  »  C  I*  » 


PF  ME T0UT2. ,///lorO 
PFNE  T  W  OR  K  3  • 

PFHf  TLlOCWU 


ASSIGN  NETWORK  WORKING  FILES 


r  r  ™  l.  munn 
PF  ME TW0RK4 . 

PFNE  TWORK8  . 

PF  NE TW0RK9 . 

PFNE  TIN15. 

-----------  ISSUE  F ILF 

PF IS  SUE  1  4 . 

PF PR IM-F ILES. ISSUE ,PF ISSUE  14 . 

___________  PARAMETER  FILE 

PFPARAMET17. 

PFPRIM-FILES.PARAMETER,PFPARAMET17. 

PFJ0BASVAL4C. 

PF  EXPE0M0S42 . 

Dcc-voc-rtnnAn-7 


£4  SG  ,  A  PF EXPE0M0S42  . 
3  4  SG  I  A  PFEX  PE0GPA43  • 
£ A  SG  •  T  PFEXPE0M0S44  . 
£  A  SG  i  A  PFUNFILLM052. 
a  A  SG i A  PF  UN  F ILLGR  5  3  • 
EiASC-.T  PFUNFILLED54. 

-  -  -  -  -  Dr  «  c  c  T  r  m  kj n  1 


Hr  UNr  1 LLLUPH  • 

PF4SSIGNM062. 

2 .. PFNETOUT2  . 

3 • *  PFNE  TUORK  3 • 

4 .. PFNETW0RK4. 

R ..PFNETWORK8. 

9.. PFNETWORK9. 

14  .  ,  PF ISSUE  14  . 

! 5  .  .PFNETIN15  . 

17  ..PFPARAMFT  17. 

21..  P  FP  R I M2 1 

40 .. PF J0BASVAL40. 

42 .. PFEXPE0M0S42. 

43 .. PFEXPE0GRA43. 

44 . . PFEXPE0M0S44  . 
e2 . <  PFUNFILLM052. 

53..  PFUNFILLGPS3. 
e4 .,PFUNFILLE054. 

£USE  62 . ,PF ASSIGNH062  . 

2XLT  PFNET. 755SUBST-M0S/4-2 
E F  R f  E  PFNE  T0UT2. 

-  PFNETW0RK3. 

PFNE  TW0RK4  . 

oc  nr  Ti  i  no  u  o 


£  A  SG 
5USl 

Su  s" 
£USE 
£U  SE 
3USE 
£U  S E 
£  U  S  F 
uU  SF 
£USr 
£U  SE 
£U  SE 
£U  S E 

£usr 
£USF 
GU  SE 
£USE 
£U  SE 


SCRATCH  FILE,  INPUT  TO  MODEL 
PARAMETER  FILE 

CONTAINS  NUMBER  OF  PEOPLE  BY  MOS 
INPUT  JOB  FILE 

output  excess  peopl  file  by  mos 

OUTPUT  EXCESS  PEOPL  FILE  BY  GRADE 
SCRATCH  EXCESS  PEOPL  FILE  BY  MOS 
OUTPUT  EXCESS  JOB  FILE  BY  JOB 
OUTPUT  UNFILLED  JOB  FILE  -  GRADE 
SCRATCH  EXCESS  PEOPL  FILE  BY  MOS 
OUTPUT  JOB  ASSIGNMENT  FILE 


£F _ 

£FiiFE 
SFREE 
£EO,R 
P  ! 

£E  D  ,R 

P  • 

£E  U  ,R 
P  f 

£  A  SG  ,  T 
£ASG,T 

3i-.ncT. 


rr  |  to  u  n  n  . 

PFNE  TUORK 9  • 
42. 

52. 

62. 


o»iu,i  XA..///2GQ0 
£ASG,T  XP..///10000 
SSOPT.ES 

FILEINZPFEXPE0M0S42. 
FILE0UT=PFEXPE0M0S42 . 
KE Y-1,9,S,A 
£E  NO 

£SOPT  ,ES 

FILEIN-PFUNFILLM052. 
FILE0UT=PFUNFILLM052. 
KEY=1C,9,S, A 
KEY-1, 9.S.A 
£E  ND 

“SORT  ,ES 

FILEIN  =  PF ASSIGN MO  62. 
FILE0UT=PFASSIGNM062. 
l  .u  .4 


KEvri 
£E  NO 
£F  rEE 
£F  REE 


►  4  ,  S  ,  A 

xA  i 

xb . 


Figure  4-14.  SUBST-M0S2ND/4-2  Runstream 
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•HOG  pEADIN£<S/5  READINESS  “POCESSOR  5  n 

STITLE  READINESS, 5I-SG  .READINESS, PROCESSOR 
fiTITLE  READINESS, 5S-5C, READINESS, PROCESSOR 


a  • 

£  .  TH3 

S  . 
i  . 

£A  SG, A 

SEO 

EXI 

a  • 

a A  SG  ,  A 
SEO 
EXI 
S  . 

■  A  SC  ,  A 

a  .  ed 

S  .  EXI 

SASG, A 
i A  SG  ,  A 
5  A  SG  ,  A 
a  A  SG , A 
a  , 

sasg.a 

a  A  SG  ,  A 
a  A  S  G  ,  A 
£  A  S  G  ,  A 
a  A  v  G  i  i 
i  A  SG  ,  A 
a  A  SG  ,  A 
iA  SG,  A 

a  • 


RUNSTREAM  EXECUTES  THE  READINESS  PROCESSOR 

---------  ASSI6N  ISSUE  FILE 

PFISjUElA. 

PFPRIM-F 1LES.ISSUE.PF ISSUE  IP. 


PFPR IH -FILES. I SSUE.PF ISSUE  IP. 

-  -  -  -  -  -  -  -  -  ASSIGN  PAP*HETER  PILE 

PFPARAMET17. 

PFPRl*-FILES.PARAMETER,PFPARAMETI7. 

----------  ASSIGN  BASE  VALUE  FILE 

PFv  ALUE 1 9  . 

PFPRIH-FILES.VALUE ,PF VALUE  19. 
-----------  ASSIGN  INPUT  FILES 


P  FMO  S I SSU  E  3 1 • 
PFASSIGN  ED6  1  • 
PFASSIGN  H06  2  . 
PFASSIGNGR63  . 


ASSIGN  OUTPUT  FILES 


aUSE 

14.  , 

ausr 

17., 

ausE 

19a, 

ausE 

31., 

aust 

6  1., 

ausE 

62., 

ausE 

63., 

ausr 

6  4., 

ausE 

6  5., 

ausE 

66.  , 

aU  SE 

67.  , 

ausE 

7  D.  , 

ausE 

72.  . 

ausE 

73.  , 

iU  SE 

74., 

SERS 

64. 

BERS 

65. 

BERS 

66. 

BERS 

67. 

aERS 

70. 

BERS 

72. 

aERS 

73. 

BERS 

74. 

ax  Q  T 

PFPR 

er  o,r 

64 

LNP  ? 
BEO.R 
LNP  f 

BE  0  ,R 

65 

66 

LNP  • 
8ED.R 
LNP  » 
BEO.R 

LNP  » 
BEO.R 

67 

70 

72 

LNP  ! 
BEO.R 
LNP  ? 
BEO.R 

73 

74 

LNPT 

0  H  i 

BF  REE 

64. 

3F  REE 

6  5. 

SF  REE 

66. 

BFREE 

67. 

bfree 

70. 

ttFREE 

72. 

BFREE 

73. 

5FREE 

74. 

PFASSIGNED64.,///1000D 
PFASSIGNM065..///SOOO 
PFASSIGN GR 66., ///5000 
PFA  SSIGNED67 • ,/// 1QCDC 
PFISSRRA  0170. ,///SOCD 
PFISSPERCP72..///500Q 
PFGRAREA0I73.,/// 1000C 
PFmOSREAOI7P.,///IOOQO 

----------  ATTACH  FILE  NUMBERS 

.PFISSUE1P. 

.PFPARAME T 17. 

,PF V  ALUE 19. 

,P  FNOS ISSUE  3 1 • 

.PFASSIGNED61. 

.PFASSIGNH062. 

, PFASSIGN GR 63. 

, PF A  S SIGN  ED6P . 

,PFASSIGNM065 . 

, PFASSIGN GP 66. 

.PFASSIGNED67. 

.PFISSREA0I7C* 

.PFISSPERCR72. 

,PFGR AREA DI73. 

.PFM0SREADI7P. 


Figure  4-15.  READINESS  Runstream 
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SH06  PRIM  REPORTS 

5PFPRIM-APS .1 ITLE ,D  F 0 RMA T T ED , RE POR T S  ,PROCE SS T 6  ,PSR S I *M .REPORTS 
8PF PR  IM-ABS .TITLE, 0  FORMATTED, REPORTS, PR0CESSl6,PtRJltM, REP  OR TS 
S,  ------------  ASSIGN  TEMPORARY  FILES  FOR  INTERNAL  SORTS 

8  A  SG  ,  T  XP..///560 
8ASG.T  XA..///80 

8.------------  ASSIGN  THE  ERROR  AND  ISSUE  FILES 

SASG.A  PFERRORI3. 

8USE  1 3  .  .PFERROR 1 J  • 

SASG.A  PF ISSUE  14  • 

SUSF  IN ..PFISSUF1R . 

a.--  -  --------  ASSIGN  THE  EXCESS  PEOPLE  FILES 

8ASG.A  PFEXCPE0P41. 

SUSE  «1  ..PFEXCPE0P4I. 

8  A  SG , A  PFEXPE0M0S42. 

8USE  42  ..PFEXPE0MOS42. 

SASG.A  PFEXPE0GRA43. 

aUSE  43..PFEXPEOGRA43. 

a.------------  ASSIGN  THE  UNFILLED  JOB  FILES 

SASG.A  PFUNFILLED50. 

SUSE  50..PFUNFILLED5C. 

SASG.A  PFUNFILLED5I. 

SUSE  S1..PFUNFILLED51. 

8  ASG , A  PF  UNF 1LLHOS2. 

SUSE  ?2  ..PFUNFILLM052. 

SASG.A  PFUNF ILLG  R53 . 

SUSE  S3  .  .PFUNF ILLGR53 . 

a  ------------  ASSIGN  THE  READINESS  FILES 

8ASG.A  PFASS1GNED64. 

SUSE  f>4  ..PF  ASSIGNED64  . 

SASG.A  PFASSIGNED67. 

SUSP  67..PFASSIGNE067. 

SASG.A  PFISSREADI70. 

SUSE  70..PF ISSREADI70. 

SASG.A  PF ISSPERCR72. 

aUSC  72 . ,PF ISSPERCR72 . 

SASG.A  PFGRARFADI73. 

SUSE  73  ..PFGRAREAOI73. 

SASG.A  PFM0SREA0I74. 

BUSE  74  ..PFM0SREA0I74. 

a  ASSIGN  THE  REPORT  RFOUEST  FILE 

SASG.A  PFREPORT93. 

8USE  R3..PFREPORT93. 

BED  PF PR IM-FI LES.RE POR T,PF REPORT  93. 

a------------  hake  SURE  THE  ABSOLUTE  FILE  IS  AVAILABLE 

SASG.A  PFPRIh-ABS. 

aFREE  PFPRIM-ABS. 

ax  Q  T  PFPPIM-ABS.755RE PORT/6 
SADD  PFPPIM-FILES. PARAMETER 


Figure  4-16.  REPORT/6  Runstream 


COMPILE 


MAP 


PROCESSOR 


1  -  1  -  I 


8 

a 

a 

8 


THIS  RUNSTREAM  COMPILES  THE  PROGRAM  "MAKE  30  IGUIC"  ,  ‘NO  MAKES  THF 
ABSOLUTE  ELEHENT  NEEDED  FOR  RUNNING  PPOCESS  1.1.1 


8  .  '  - 
a  . 

SASG.A 
SASG.A 
i  A  SG  ,  A 

s  . 
s  . 

sftn.fs 

SEOF 

i  : 

8MAP 

IN 

ENO 

S  . 

SPACK 

SPACK 

SPACK 


PFPRIM-ABS. 

PFPR  IM-REl  . 

PFPR1M-SYMB . 

-  -  -  COMPILE  THE  MAIN  (AND  ONLY*  PROGRAM 
PFPRIM-SYMB.R0LU1C/1-1-1.PF PR IM-REL .ROLUI C/ 1- 1- 1 

-  -  -  MAKE  THE  ABSOLUTE  ELEMENT  (EXECUTABLE  PROGRAHI 

, PFPRIH-ABS. 7 S5R0LU1C/ 1-1- 1 
PF PR IM-REL .ROLUIC/ 1-1-1 

PFPRIK-ABS. 

PFPRIH-REL. 

PFPRIM-SYMB . 


THE  RUNSTREAM  FOR  THE  ACTUAL  RUN  IS: 

PFPR IM-RUN. MAKE  30 IGUIC/ 1-1-1 


Figure  4-17.  ROLUIC/1-1-1  Compile  amd  Map  Runstream 
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a  . 
a  . 
a  . 
a  . 

a  : 
a  . 

a  .  -  ■ 
a  . 
a  . 
a  . 
a  . 

a»SG,A 

aa$G,A 

a  . 
a  . 
a  . 

3F  T  N.  F 

ar  tn, f 
ap  ack 
aFREE 
a  . 
a  . 
a  . 

a  A  §G  ,  A 

a  . 
a  . 
a  . 
aw  ap 

IN 

IN 

IN 

END 

a  . 

an  ap 

IN 

IN 

IN 

IN 

l"“ 

a  . 
a  . 

aPACK 

aFREE 

aPACK 

8FRFE 


COMPILE  ANO  MAP  PROCESSOR  1-1-2 
THE  ABSOLUTE  ELEMENT  CREATEO  BY  THIS  RUNSTREAM  WILL  AGGREGATE 
THE  MOS  DATA  FROM  THE  6-DIGIT  UIC  LEVEL  TO  THE  3-DIGIT  UIC  LEVEL 


-  -  ASSIGN  THE  FILES  FOR  THE  SYMBOLIC  IF  OR  TR  AN  T  AND  RELATIVE 
VERSIONS  OF  THE  ROLMOS  PROGRAM  (PROCESSOR  1-I-2J 

PFPRIM-REL. 

PF  PR  IM-SYM8 . 

-  -  COMPILE  THE  MAIN  PROGRAMS 

PFPRI M-S YMB. SEPARATE/ 1-1- 2A, PFPRIM-REL. SEP AR A TE/1-1 -2 A 
PF PRIM-SYMB. ROLMOS/ 1- 1-2. PF PR IM-REL .ROLMOS/ 1-1-2 
PFPRIM-SYMB. 

PFPRIM-SYMP. 

-  -  ASSIGN  THE  FILE  FOR  THE  ABSOLUTE  ELEMENTS  AND  THE  UTILITY 

PROGRAM  FILE 

PFPRIM-ABS. 

-  -  MAKE  THE  ABSOLUTE  ELEMENTS  IMAP  THE  PBOGRAMSI 

.PFPRIM-ABS .75 5  SEPARATE/ 1-1-2A 
PFPRIM-REL .separate/i-i -2  a 
PFPRIM-REL .CHKNUL 
PFPRIM-REL .WRTERR 


.PFPRIM-ABS. 755ROLMOS/1-1-2 
PF PR  IM-REL. ROLMOS/ 1-1-2 
PFPRIM-REL. WRTERR 
PFPR IM-REL. ICHINT 
PFPRIM-REL. F2FRT 


-  -  FREE  THE  FILES  USEO  ANO  STOP 

PFPRIH-REL. 

PFPRIM-REL. 

PFPRIM-ABS. 

PFPRIM-A8S. 


•  • 


Figure  4-18.  ROLMOS/1-1-2  Compile  and  Map  Runstream 
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STOP :HOG 
S  . 

3*  SG  *  A 
SASG'A 
sasg.a 
a  . 
a  . 
a  . 
a  . 

spop.f 
a  . 

ariN.F 
3FTN.F 
SF  TN,F 
8FTN.F 
3FIN.F 
ar  TN,F 
SF  TN,F 
3F  T N , F 
SF  TN,F 
aF  TN,F 

a  . 
a  . 
a  . 
an  a p 

IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 
END 

a  . 
a  . 
a  . 
a  p  A  CM 
3PACK 
SPACK 


PROCESSOR  1-2 


MAP-SETISSUE/i-2 

PFPPIM-ABS. 
PFPRIM-PEL . 
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ar0P:FTN,0  PFPRIM-SYMB .SI* ,  PF PR IM -R EL  .S I  X 

3T0P:ETN,P  PFPR IM-SYMB  .SEVEN,  PF PR IM -R E L  .  S E VEN 

aMSG.N 

aTOP:MAP,E  ,PF PR  I M  -AB S  .  7 S 5S UB S T  -GRO  /  4 - 1 

IN  PFPRIM-REL  .GROMAIN 

IN  PFPRIM-REL  .F2FRT 

IN  PFPR IM-REL  .PREGRO 

IN  PFPRIM-REL  .PSTGRO 

IN  PFPRIM-REL  .FORM 

IN  PFPRIM-REL .AOOMFP 

IN  PFPRIM-REL  .BUILD 

IN  PFPRIM-REL  .SNET 

IN  PFPR  iH-fitL  .R IGHT 

IN  PFPR  IM-REL  .REPORT  . 

IN  PFPRIM-REL  .SORTTG 
IN  FFPRIM-REL  .FOUR 
IN  PFPR  IM-REL  .F  IVE 
IN  PFPRIM-REL .SIX 
IN  PFPRIM-REL .SEVEN 
ENO 

3PACK  PFPRIM-REL, 
aPACK  PFPPIM-SYM8. 

3FREE  PFPPIH-SYMB. 

scree  pfppim-rel. 

3FREE  PFPPIM-ABS. 


Figure  4-27.  SUBST-GRD/4-1  Compile  and  Map  Runstream 


3  A  SG  »  A 


PFPriM-AfcS. 
PF  PPIM-RCL . 

PfPR IH-StM0 . 


m  A  p  SUPSTirurr 


H  0  5 


iPOP*F  PTPR IM-SYM0 .PL QCKPA TA f  PF P R I M -S Y M P  .  P L 0 C K D A T A 

•  END 

iTOP:FTNtO  PFPRIM-SVH0  .MOSMAIN  ,  P F P D  I  M  -  R £ L  •  M 0 S M A  I N 

dT0r:FTN,0  PFPRIM-S  YMfc  •PF'E.HOS  ,  P  F  P  p  I  M -P  E  L  ,  p  R  r  MO  S 

i  T  0  P  :  F  TN»0  PFPPlM-$YMb  .PS  IMOS*  PFPRIM-REL  •  P  S  T  MO  S 

STOPjf  TNfO  PFPRIM-SYMB  .MOSENO,  PF P R  I M - R E L  .  HO S E N 0 

iIOP:FTNtP  PFPRIM-SYM8 .FORM.  PFPRIM-RpL  •FORM 

iTOF:f  TN,0  P F P R I M -S YM b  .  A PO PF P  ,  PF P R I M -R E L  .  A DUMF P 

aroP:FTN,0  PFPRIM-SYME  .PtULO*  PFPR  IM-REL  .BUILD 

STOPjFTN.O  PF PR1M-S YMB  .SNE T  ,  PFPR  IM-REL  .SNET 

iTuP:FTNtO  P  F  P  R  I  M -S  YM  fa  .  R  I G  H  t  .  PF PR  I  M  -  R E L  •  R  I  GH T 

»TOP:F  Tn»P  prpRlM-S YMfi  .RFPCR T  ,  P F P R  I M  -  R E L  .  R E P OR T 

STOP:FIN,0  PFpRlM-SYHb.SCRTTG,  PF P R  I M  -  R E L  .  S OR T  1  G 

i TOT  :f  7  Nf  0  PFr RIM-5 YMb #F CUP,  PF PR  I M -R E L . F OU R 

STQP:F  TNfO  PFPRIM-SYMB  .F IVE  v  PF PR  I M -R E L  .  F  I  V E 

aTOP:FTNfO  PFPRiM-S YMfi  .S TX t  PF PR  IM-REL  .S  I  X 

dT0r:FTN,0  PFPRIM -S YM6  .SE VEN  ,  PFPR  IM-REI  .SEVFN 

•  TOTrMAP.r  tPF  PR IM  -  APS • 7SSS UB ST -M0S/4-? 

IN  PF PR  IM -R EL  .MOSM A  I N 

IN  PF  PR  IM-REL  .F  2F  R  I 
IN  PFPR  IM-REL  .PREMOS 
IN  P F PR  IM-REL  .PSTMOS 
IN  PF PR  IM-REL  .HOSEND 
IN  PF PR  IM-REL  .F ORM 
IN  PFPR  IM-REL  .AODMFP 
IN  Pf  PR  IM-REL  .BUILD 
IN  PFPRIM-REL  .SNE  T 
IN  PFPR  IM-REL  .R  IGHT 
IN  PF PP  IM-REL  .REPOR T 
IN  PFPRIM-REL  .SORTTG 
IN  PFPRIM-REL  .F  OUR 


IN  PFPRIM-REL  .F  IVE 
IN  PFPR  IM-REL  .S  IX 
IN  PFPR  IM-REL  .SEVEN 
ENO 

A  • 

8PACK  PFPPlH-AeS* 
iPACK  PFPPIM-PEL. 
dPATK  PFPOIM-SVMB . 


<4  -  ? 


Figure  4-28.  SUBST-MOS/4-2  Compile  and  Map  Runstream 
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3  A  SG  ,  A  PFPRIM-SYHB. 

3 A  SG  t  A  PFPRIM-REL. 

3  A  SO  ,  A  PFPRIM-ABS. 

SFTNtO  PFPP IM-SYMB » READINESS/5  .  PFPRIM-REL  .RE AOINESS/ 5 

SH  AP , E  ,PFPRIM-ABs.Y55REAOINESS/5 

IN  PFPRIM-REL  .F2FRT 

IN  PFPRIM-REL. READINESS/5 

END 

SPACK  PFPPIM-REL. 

3PACK  PFPRIM-SYMB. 

3FREE  PFPRIM-SYMB. 

3F  REE  PFPRIM-REL. 

3F  REE  PFPPIM-ABS. 


Figure  4-29.  REAOINESS/5  Compile  and  Map  Runstream 


a  .  HOG 
PFPP I M- 
PFPPIM- 
SASG,  A 
a  A  SG  t  A 
a  A  SG  ,  A 
SPOP.F 
SF  TN.F 
aF  TN,F 
SF TN.F 
SF IN.F 
SF  TN,F 
aF  TN.F 
aFTN.F 
aF  tn.f 

aF  TN.F 
aFTN.F 
aFTN.F 
aF  TN.F 
aF  TN.F 
ap  tn.f 

aF  TN.F 

an  ap 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

ENO 

aPACK 

aPACK 

aPACK 

8FREE 

aF  HE  E 

aFREE 


PRIM  REPORT  COMPILE  AND 
ABS. TITLE.O  COMPILE .ANOIMAP.PEPORTS .PR0CESSi6 
ABS.  T I TLE^O^COM PILE .AND* MAP, REPORTS  .PROCESS* 6 

PF  PR IM-ABS ! 

PF  PR  IM-SYMB  . 

PFPRIM-SYHB.  REPORTPPOC. PF PR IM-SYMB.  RE PORTPROC 
PFPRIM-SYMB.0PlVE6.pFpR IM-rEL.DRI VE6 

PFPRIM-S YMB. REPTQ1, PF PR IM-R EL  .REP  TO  1 
PFPRIM-SYMB. RE PTOZ.PF PRIM -REL.REPTQZ 
PFPRIM-SYMB. REP  TO  3, PFPRIM-REL .REP  TO  3 
PFPRIM-SYHB.REPTOA.PFPRIH-REl.REPTOM 
PFPRI M-SYMB. REP T05, PFPRIM-REL .REPT05 
r FPR IM-SYMB .REP T06 ,PF PR IM-REL .REP T 06 

E^SJM-SY"B.RFPT07,  PFPRIM-REL. REPT07 

PFPRIM-SYMB. RE PT08.PF PR IM-REL. REPT08 
PFPRIM-SYHB. RE PT 09, PF PR IM-REL. REPT09 

pfprim-syhb.repuo.pfprim-rel.reptio 

PFPRIM-SYMB .REP T II, PF PRIM -REl.REPT 11 
PFPRIM-SYHb.ZERODV.PFPRIM-REL.ZERODV 
PFPRIM-SYMB.PAR.PFPRIM-REL.PAR 
PFPRIH-SYMB.ISSUNA.PFPRIM-REL.ISSUNA 
.PFPRIM-ABS.755BEP0RT/6 
PFPRIM-REL .ORI VE6 
PFPRIM-REL. REPT01 
PFPRIM-REL .REP  T02 
PrPRIM-REL.REPT03 
PFPRIM-REL .REP  T09 
PFPRIM-REL. REPT05 
PFPRIM-REL .REP  T06 
PFPRIM-REL. REPT07 
PFPRIM-REL .REPT06 
PFPRIM-REL. PEPT09 
PFPRIM-REL.REPT10 
PFPRIM-REL. REPTU 
PFPRIM-REL. F2FRT 
PFPRIM-REL.HRTERR 
PFPRIM-REL .PAR 
PFPRIM-REL. GETOAY 
PFPRIM-REL. ISSUNA 
PFPRIM-REL. ICHINT 
PFPRIM-REL. 7ER00V 

PFPRIM-SYMB . 

PFPRIM-REL . 

PFPRI M- ABS. 

P  F  PP I M-SYMB  . 

PFPRIM-REL  . 

PFPPIM-ABS  . 


MAP 
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Figure  4-30.  REPORT/6  Compile  and  Map  Runstream 
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a 

a 

a 

a 

a 

a 

a 

a 

a 

a 

a 

a 

a 

a 

a 


THIS  RL'NSTRL  COfTTLES  THE  P®!"  UTILITY  SUBROUTINES 


SINCE  THE  PRIM  UTILITY  PFOGRAHS  ART  A  MIXTURE  OF  PROGRAMS  THAT 
WERE  PROGRAMME  P  AT  C/A  A»D  PROGRAMS  THAT  ARE  ON  THE  MILPERCEN 
SYSTEM,  BUT  NOT  A  PART  OF  THE  S  Y  S  T r  M  DOCUMENTATION,  THE  UTILITY 
PROGRAMS  ARE  ACCESSEf  IN  A  VARIETY  Or  M  A  NN  E  R  S  THAT  ARE  DISCUSSED 


a  • 
a  . 


a  . 
a  . 
a  . 
a  . 
a  . 
a  . 
a  . 
a  • 
a  . 
a  . 
a  • 
a  • 


a  . 

a  • 


a  . 


PELOU 


APR  TCA 

F2FRTS 

GETOAY 

GETWCT 

ICHINT 

TC0MP2 

RCHFLT 

TITLE 

WRTERR 


a  • 
a  • 
a  . 
a  . 
a  . 
a  . 

a  A  S  G  ,  A 
a  A  S  G  ,  A 
a  A  SG  ,  A 

a  . 
a  • 


A  UTILITY  PROGRAM  FURNISHED  BY  THF  SPERRY  SYSTEM 
REPRCSENTATIVF  IN  THE  REL/TtVE  VERSION  ONLY.  IT 
IS,  THEREFORE T  NOT  COMPILED. 

AN  ASSEKTLY  LANGUAGE  PROGRAM  WRITTEN  TO  THE  SYSTEM 
SPECIFICATION.  IT  CHAN3ES  THE  LI“IT  OF  THE  ALLOWABLE 
UNIT  NUHETR  REFERENCES  FROM  30  TO  99. 

A  FORTRAN  PPOGRAH  STORED  TN  THE  UTILITY  FILE 

A  FORTRAN  PROGRAM  STORED  IN  THE  UTILITY  FILE 

A  FORTRAN  FUNCTION  STORED  IN  THE  UTILITY  FILE 

A  FORTRAN  FUNCTION  STOFEP  IN  THE  UTILITY  FILE 
WITHIN  IN  A  S  F  T  OF  PROGRAMS  CALLED  BSERCH 

A  FORTRAN  FUNCTION  STORED  I*'  THE  UTILITY  FILE 


A  UTILITY  PROGRAM  FURNISHED  BY  THE  SPERRY  SYSTEM 
RFFFr sENT/TIvr  IN  THE  A  3  SDLUTE  VERSION  ONLY.  IT 
IS,  THEREFORE ,  NOT  COMPILED. 

THIS  PROGRAM  IS  A  UTILITY  BrCAUSE  IT  IS  USED  PY 
MORE  THAN  ONE  PROCESSOR.  HOWEVER,  SINCE  IT  WAS 
WRITTEN  ESPECIALLY  FOP  PPlM,  IT  MAY  NEED  To  BE 
CHANGED  AS  LATER  VERSIONS  Or  PRIM  EVOLVE.  IT  IS, 
THEREFOPF,  STORED  IN  THE  P R TM -S YM R OL I C  FILE. 


ASSIGN  THE  FILES 

PFPR I M -R  EL  . 
PFPRIM-5YMP  . 
PFPR I M -UTIL  . 


a'  .  - 

a  • 

aTOP  :PDP,FS 
aTOP  :FTN , FS 
aTOP  :FTN  ,FS 
STOP  :FTN,FS 
3T0P  :FTn  ,FS 
aTOP  :FTN  ,FS 
dTOP:FTN,FS 

a  . 

a  .  — 

®  • 

aPACK 

aPACK 

spacm 


COMPILE  THE  PROGRAMS 

E-FPRI” -SYMP. PRIM -E  ROCS,  PF°P  I  M-SYMB. MAIN-PRO  CS 
PEPRI  II -UTIL.  BSERCH,  PFPR  IM-REL.  BSERCH 
PFPRIM-UTIL .GETDAY , PFPR IM-PEL  .GETDAY 
PFPRIM-UTTL. GETWCT, PF PR IM-RTL. GETWCT 
PFPRIM-UTIL. ICHINT, PFPRTM- RE L. ICHINT 
pr PRIM-UTIL. RCHTLT, PFPR IM-REL. RCHFLT 
PFPR I M -S  YH G  . WRT ER R,PF PR  IM -PEL  .WPTERP 

PACK  THE  FILES  THAT  MAY  HAVE  B r E N  MADE  BIGGER 

PFPR IM-PEL . 

PEPRIM-SYMr . 

PFPRIM-UTIL  . 


Figure  4-31.  Compile  PRIM  Utility  Programs 
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THESE  FILES  WOULD  BE  NEEDED  TO  CREATE  THE  PRIM  SYSTEM  FROM  A  BACKUP 
FILE  t  IF  ALL  PR0GRA“S  HAD  BEEN  DELETED  FOR  AN  INACTIVE  PERIOD 


THE  FILES  WHICH  WILL  BE  NEEDED  FROM  TAPE  ARE  THE  SYMBOLIC 
VERSIONS  OF  THE  PROGRAMS,  THE  MAP  RUNSTREAKS,  THE  RUNSTREAMS 
AND  THE  UTILITY  PROGRAMS 


THE  °ELATIVE  AND  ABSOLUTE  ELEMENTS  CAN  BE  CREATED  USING  THE 
MAP  FUNSTREAMS.  THE  RUNSTREAMS  TO  CREATE  THE  REST  OF  THE  FILES 
WILL  BE  FOUND  IN  THE  RUNSTREAM  FILE • 


»SG,CP 
ISG.CP 
iS6,CP 
A  SG  ,  C  P 
ASG.CP 
A  SG  ,  C  P 
ASG.CP 


PFPRIM 
PFPR  IM' 
PFPRIM 
PFPRIM 
PFPRIM 
PFPRIM 
PFPRIM 


-AES.,/// 1000 
-FILES.  ,///lOOQ 


■MAP,,///  1000 
■PEL.  ,///  1000 
•RUN.  ,///1000 
■S  YMB  •  ,  //  /  1  000 
•UTIL..///10QO 


ABSOLUTE  ELEMENTS 
USER-DEFINED  (CONTROL)  FILES 
MAP  RUNSTREAMS  -  CREATE  ABSOLUTES 
RELATIVE  VERSIONS  OF  PROGRAMS 
RUNSTREAMS 

SYMBOLIC  (FORTRAN)  PROGRAMS 
PRIM  UTILITY  PROGRAMS  (SYMBOLIC) 


Figure  4-32.  Commands  to  Create  PRIM  System  From  Tape  Backup 


HOG  PFP  °I 
T  THIS  R 
ASG,  CP 


M-RUN  ASSIG 
UNSTREAM  CR 
PFINPUTM 


NPROC 
EATES 
0S8 . , // / 1 OOCO 


-1 - CREATE  PREPROCESSOR  FILES 

THE  FILES  NEEDED  BY  THE  PRIM  PREPROCESSOR 


THIS  IS  ORIGINAL  MOS  INPUT 
AND  MUST  CONTAIN  DATA 


ASG, CP 
A  SC, CP 


PFERR0R1 

PFISSUE1 


3.  ,// 
4.,// 


/iroo 

/IOC 


ISSUE  FILE  SHOULD  BE  UPDATED 
IN  PFPRIM-FILES 


ASG, CP 
ASG, CP 


ASG, CP 


PFPARAME  T17  .  , 
PFVALUE1 
PFUIC6DI 


.9.,// 


///100 

/ICC 


PARAMETER  file  SHOULD  be  updated 
IN  PFPRIM-FILES 


VALUE  FILE  SHOULD  BE  UPDATED 

in  pfprim-files 


ASG, CP 
A  SG,CP 
A  SC  , CP 
A  SG ,CP 
A  SG  ,CP 
ASG,  CP 
A  SG ,CP 
ASG  , CP 
ASG, CP 
B  A  SG , C  P 
£  A  SG , CP 


G22 . , ///10C0 

THE  FOLLOWING  FILES  MAY  BE  BLANK 


THIS  IS  ORIGINAL  UIC  INPUT 


PFUICIDI 

PFUICDAT 

PFUICDAT 

PFMOS-EN 

PFMOS-OF 

PFMOS-WO 

pfmosda  t 
pfmosdat 
pfmosiss 

PFGRASTR 

PFMOSSTR 


G2  3  .  , 
A24 ,; 
A  2  5  .  , 
L-26. 
F-27. 
— 2B  •  , 
A ?9  .  , 
A  3  0  .  , 
UE  3  1  . 
En8S  . 
EN86. 


///icon 
///1000 
///1000 
,/// I0D00 
,/// 10000 
///logo 
///10000 
// / 1 oooc 

,///10C0C 

,/// loo 

.///1000C 
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Figure  4-33.  Create  Preprocessor  Files 
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iHOG  PFPRIM-RUN  ASSIGN -PP0C2  -  CrLATf  POLICY  PROCESSOR  FILES 

o  • 

5  .  THIS  R  UN  ST  RE  AH  CREATES  THE  FILES  NEEDED  BY  THE  PRIM  POLICY  PROCESSOR 


S  •  --------------- 

a  . 

SASG.CP  PFAGISP032..///1000 

SASG.CP  PFISSP0L33. .///IGQD 

SASG.CP  PFH0SP0L34..///1CC0 

SASG.CP  PFISMOPO 35. ,/// 1000 

S  A  SG  ,  CF  PFISM0EX36..///100Q0 

iASC-.CP  PFMOSEXT  37..///1C0DC 

SASG.CP  PFISSEXT3P..///10C00 

SASG.CP  PFJOEASV AL39. ,/// lODUO 

SASG.CP  PFJ06ASV  AL4 C  • ,/// 1QD00 

SASG.CP  PFUNFILLED5D. ,///10C0 

SASG.CP  PFAGISIN090. 

S  . 

SASG.CP  PFP0LICY91. 


ALL  FILES  MAY  BE  BLANK 
(UPDATE  POLICY  IN  PFP R IM -FI LE S J 

.  AGGREGATED  ISSUE  POLICY 
.  ISSUE  POLICY 
.  MOS  POLICY 
.  COMBINED  POLICY 
.  COMBINED  EXTRA  JOB 
.  MOS  EXTRA  JOB 
.  ISSUE  EXTRA  JOB 
.  JAV  SCRATCH 
.  JOB  ASSIGNMENT  VALUE 
.  UNFILLED  JOBS 
.  AGGREGATED  INDICATORS 

POLICY  FILE  —  MUST  BE  UPDATED 
IN  PFPRIM-FILES 


SASG.CP  P  FED IPOL  92  .  .  EDITED  POLICY 


Figure  4-34.  Create  Policy  Processor  Files 

$HOG  PFPrI M-RUN  ASSIGN-PR0C3  -  CREATE  ASSIGNMENT  PROCESSOR  FILES 

a  • 

S  .  THIS  RUNSTREAM  CREATES  THE  FILES  NEEDED  BY  THE  PRIM  ASSIGNMENT  PROCESSOR 

S  T  THE  PRIM  SUBSTITUTE  ASSIGNMENT  PROCESSOR,  AND  THE  READINESS  PROCESSOR 

S  ALL  OF  THESE  FILES  MAY  BE  BLANK  -  WILL  BE  WRITTEN  TO  BY  PROGRAMS 

SASG.CP  PFNETIN15..///1D00Q 

SASG.CP  PFEXCPE0P9I .. ///500 

SASG.CP  PFEXPG0M0S42. ,///SOC 

SASG.CP  PFEXPEOGR A43. ,///5DD 

SASG.CP  PFEXPE0MCS44.///5C0 

SASG.CP  PFUNFILLED51 ..///500D 

SASG.CP  PFUNFILLM052. .///5000 

SASG.CP  PFUNFILLM053.  ,///5000 

SASG.CP  PFUNFILLGR53.  ,///50DD 

SASG.CP  PFUNFILLED54  .  .///50D0 

SASG.CP  PFASSIGNED61..///50D0 

SASG.CP  PFASSIGNM062 . ,///5000 

SASG.CP  PFASSIGNGR63. ,///5DD0 

SASG.CP  PFASSIGNED67..///50D0 

SASG.CP  PFISSREA DI7D. ,///500u 

SASG.CP  PFISSPERCR72. ,///50CG 

SASG.CP  PFGR ARE  A DI73 . ,///50Cu 

SASG.CP  PFMOSRE A  CI74 , ,/// 5000 

SASG.CP  PFREPORT  93. 

3FREE  PFNETIN15. 

SFREE  PFEXCPE0P41. 

SF  REE  PFEXPE0M0S42. 

SFREE  PFEXPE0GRA43. 

SFREE  PFEXPE0M0S44 

SFREE  PFUNF ILLEDE 1 . 

SFREE  PFUNFILLM0E2. 

SFREE  PFUNFILLGP53. 

SFREE  PFUNFILL ED54 . 

SFREE  P  F  A  SS  I  GN  EDfc  1  • 

SFREE  PFASSIGNM0o2 . 

SFREE  PFASSIGNGR63. 

SFREE  PFASSIGNEC67. 

SFREE  PFISSREA 0173. 

SFREE  PFISSPERCP7?. 

SFREE  PFGR AREA  0173  . 

SFREE  PF**r'SPEA0I74  . 

SFREE  PF*.  WP0RT93« 

Figure  4-35.  Create  Rest  of  PRIM  Files 
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»' 

k 

l 

File  number 

APPENDIX  A 

DATA  DICTIONARY 

* 

i 

Name 

or 

subroutine 

Format 

Description 

i 

AGASGR 

73 

16 

Aggregate  assigned  over 
all  MOS  for  each  grade 

- 

c 

AGASMO 

74 

16 

Aggregate  assigned  over 
all  grades  for  each  MOS 

r 

AGASOK 

70 

16 

Correct  MOS  assigned 
aggregate 

w 

AGASSE 

70 

16 

Senior  grade  assigned 
aggregate 

AGAUGR 

73 

16 

Aggregate  authorized  over 

2  !• 

AGAUOK 

85 

15 

all  MOS  for  each  grade 

70 

16 

Correct  MOS  authorized 
aggregate 

“  i 

*“ 

AGAUMO 

74 

16 

Aggregate  authorized  over 

i 

AGAUSE 

86 

112  . 

all  grades  for  each  MOS 

-  ■— 

70 

16 

Aggregate  authorized 
senior  grades 

- 

AGAVGR 

73 

16 

Aggregate  available  over 
all  MOS  for  each  grade 

AGAVMO 

74 

16 

Aggregate  available  over 
all  grades  for  each  MOS 

• 

AGAVOK 

70 

16 

Correct  MOS  available 
aggregate 

‘  V'  '/ 

AGAVSE 

70 

16 

Aggregate  available 
senior  grades 

- 

A-l 
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File  number 

Name 

or 

Format 

Description 

subroutine 

AGG 

32 

A3 

Indicator  of  need  to 

33 

aggregate  grades  or  not 

34 

(yes/no) 

35 

91 

92 

AGGASS 

70 

16 

Aggregate  assigned  strength 

AGGAUT 

70 

16 

Aggregate  authorized  strength 

85 

19 

AGGAVA 

70 

16 

Aggregate  available  strength 

AGGFIL 

39 

16 

Desired  aggregate  fill 

40 

AGGMAX 

39 

16 

Minimum  aggregate  fill 

40 

AGGMIN 

39 

16 

Minimum  aggregate  fill 

40 

AGGREQ 

70 

16 

Required  aggregate  strength 

85 

19 

AGGVAL 

39 

16 

Value  of  filling  to  this 

40 

aggregate 

AGINO 

90 

i: 

Grade  aggregation  indicators 

AGPER 

90 

F5.3 

Aggregate  percentages 

AGREGR 

73 

16 

Required  aggregate  over 

85 

15 

all  MOS  for  each  grade 

AGREMO 

74 

16 

Required  aggregate  over 

86 

112 

all  grades  for  each  MOS 

AGREOK 

70 

16 

Correct  MOS  required 
aggregate 

AGRESE 

70 

16 

Senior  grade  required 
aggregate 

CAA-D-84-2 


Name 

File  number 
or 

Format 

Description 

ALPHA 

subroutines 

ICHINT 

A 

Alphanumeric  representation 

AMOSC 

RCHFLT 

74 

12 

of  integer  or  real  number 

C-rating  based  on  authorized 

ASOAT 

17 

16 

Input  as  of  date 

ASGMT 

21 

14 

A2 

MACOM  or  organization 

ASI 

22 

23 

24 

25 

26 

A2 

Additional  skill  identifier 

APAUOK 

27 

28 

29 

30 

31 

36 

37 

38 

72 

F7.1 

Correct  MOS  assigned 

APREOK 

72 

F7.1 

aggregate  divided  by 
aggregate  authorized 
strength--multipl ied 
by  100 

Correct  MOS  available 

ASPEAU 

64 

F5.1 

aggregate  divided  by 
aggregate  required 
strength-multiplied  by 

100 

Assigned  strength  divided 

67 

by  authorized  strength- 
multiplied  by  100 

Senior  grade  required 
aggregate  divided  by  senior 
grade  authorized  strengthe¬ 
ns  It  ip  lied  by  100 


ASSEPE 


72 


F7.1 


CAA-D-84-2 

Name 

ASSSTR 

AUASC 

AUASPE 

AUPERE 

AVPEAU 

AUSAGE 

AUSCIV 

AUSENL 


File  number 

or  Format  Description 

subroutines 


61 

62 

63 

64 

65 

66 
67 

72 


72 


61 

62 

63 

64 

65 

66 

61 

62 

63 

64 

65 

66 

22 

23 

24 

25 

22 

23 

24 

25 

22 

23 

24 

25 


17  Assigned  strength 


12  C-rating  based  on  AVASPE 

(aggregate) 

F7.1  Aggregated  assigned  strength 

divided  by  aggregated  auth¬ 
orized  strength--multiplied 
by  100 

F5.1  Available  strength  divided 

by  required  strength-- 
multiplied  by  100 


F5.1  Available  strength  divided 

by  authorized  strength-- 
multiplied  by  100 


14  Aggregated  authorized 

strengths 


14  Authorized  strength, 

civilian 


14  Authorized  strength, 

enl i sted 


A-4 


CAA-D-84-2 


File  number 

Name 

or 

Format 

Description 

subroutine 

AUSOFF 

22 

14 

Authorized  strength, 

23 

officers 

24 

25 

AUSWOF 

22 

14 

Authorized  strength, 

23 

warrant  officers 

24 

25 

AUTSTk 

8 

13 

Authorized  strength 

26 

13 

27 

13 

28 

13 

29 

14 

30 

14 

31 

16 

36 

16 

37 

16 

38 

16 

AVSEC 

72 

12 

C-rating  based  on  AVSEPE 
(senior  grade) 

AVSEPE 

72 

F7.1 

Senior  grade  available 
aggregate  divided  by  senior 
grade  required  aggregate-- 
multiplied  by  100 

BEGIN 

ICHINT 

I 

Number  of  the  beginning 

RCHFLT 

character  for  conversion 

ClVALA 

17 

A6 

C1/C2  break  for  aggregates 

ClVALM 

17 

A6 

C1/C2  break  for  MOS  &  high  5 

C2VALA 

17 

A6 

C2/C3  break  for  aggregates 

C2VALM 

17 

A6 

C2/C3  break  for  MOS  &  high  5 

C3VALA 

17 

A6 

C3/C4  break  for  aggregates 

C3VALM 

17 

A6 

C3/C4  break  for  MOS  &  high  5 

A-5 


Name 


File  number 
or 

subroutine 


Format 


Description 


CHKFIE 

CMF 


COMPO 


COMPUT 

DEMAN 


CHKNUM 

8 

21 

26 

27 

28 

29 

30 

31 

36 

37 

38 

39 

40 
86 

22 

23 

24 

25 

90 


36 

37 

38 

39 


A  Field  to  be  checked 

A2  Career  management  field 


11 

Component 

11 

Indicator  for  individual 

grade  policy 

A9 

Name  used  to  label  demand 

node.  The  first  four  char 

acters  are  the  issue  code. 

CAA-D-84-2 


Name 

File  number 
or 

subroutine 

Format 

Description 

DESCRI 

17 

A66 

Description 

EH 

GETWCT 

I 

Elapsed  time  -  hours 

EM 

GETWCT 

I 

Elapsed  time  -  minutes 

ES 

GETWCT 

I 

Elapsed  time  -  seconds 

ENLSUB 

17 

A3 

Enlisted  grade  level 
submission  (yes/no) 

FLAG 

ICHINT 

RCHFLT 

I 

Flag  indicating  successful 
conversion  from  character 

GRADE 

8 

26 

27 

28 

29 

30 

31 

36 

37 

38 

61 

62 

63 

64 

65 

66 

73 

85 

A2 

Grade 

GRAF  I L 

39 

40 

16 

Desired  fill  level  for 
grade 

GRAMAX 

39 

40 

16 

Max  imum  fill  level  for 
grade 

GRAM IN 

39 

40 

16 

Mi n imum  fill  leve 1  for 
grade 

GRAVAL 

39 

40 

16 

Value  for  filling  grade 
level 

A-7 


CAA-D-84-2 


Name 

File  number 
or 

Format 

GRDACT 

subroutine 

61 

A2 

GRDFRM 

62 

63 

17 

A2 

GRDGRP 

26 

A16 

GRDREQ 

27 

28 

29 

30 

31 

36 

37 

38 

61 

A2 

GRDTO 

62 

63 

64 

17 

A2 

GRVAGR 

39 

416 

HIGRAD 

40 

32 

A2 

H5ASAG 

33 

34 

35 

39 

40 

91 

92 

70 

16 

H5ASM0 

74 

16 

H5AUAG 

70 

16 

I 

Description 


Actual  grade  filling 
demand 

Grade  from  which  to  make 
substitution 

Grade  group  -  included  are 
GRADE 
ASI 
LIC 
I  DENT 
REQSTR 
AUSTR 
AUSSTR 


Grade  required  for  demand 


Grade  to  which  substitution 
is  to  be  made 

Grade  value  group 
Includes  GRAFIL,  GRAMIN, 
GRAMAX,  GRAVAL 

Highest  grade  to  which 
policy  applies 


Hign  5  assigned  aggregate 
High  5  assigned  in  MOS 
High  5  authorized  aggregate 
High  5  authorized  in  MOS 


H5AUM0 


74 


16 


Name 

File  number 
or 

Format 

Description 

H5AUPE 

subroutine 

72 

F7.1 

High  5  assigned  aggregate 

H5AVAG 

70 

16 

divided  by  high  5  authorized 
aggregate 

High  5  available  aggregate 

H5AVM0 

74 

16 

High  5  available  in  MOS 

H5REAG 

70 

16 

High  5  required  aggregate 

H5REM0 

74 

16 

High  5  required  in  MOS 

H5REPE 

72 

F7.1 

High  5  available  aggregate 

IDEBUG 

SETTPS 

I 

divided  by  high  5  required 
aggregate 

Flag  for  debug  print 

IDENT 

SETUIC 

SETASG 

SETMDS 

AGGCHK 

D0ITN0 

D0IT12 

8 

A1 

Type  of  person  for  position. 

IDIFF1 

26 

27 

28 

29 

30 

31 

36 

37 

38 

2 

Binary 

Male,  female,  either,  and 
whether  ENL,  WO,  or  OFF 

Resource  category  pointer  to 

IDIFF2 

2 

Binary 

MOS  in  (NAMES)  array 

Activity  pointer;  points  to 

grade  in  (IACT) 

IDIFF3 


2 


Binary 


Demand  points  to  job  in 
NAMES  array 


CAA-D-84-2 


Name 

File  number 
or 

subroutine 

Format 

Description 

IDIFF4 

2 

Binary 

Number  of  people  assigned 
to  job 

ID1 

14 

ISSFIN 

SETASG 

SETTPS 

SETUIC 

A6 

First  method  of  identifying 
ISSUE  ' 

ID1VAL 

14 

SETASG 

SETTPS 

SETUIC 

A6 

Value  associated  with  first 
method  of  identifying  ISSUE 

ID2 

14 

ISSFIN 

SETASG 

SETTPS 

SETUIC 

A6 

Second  method  of  identifying 
ISSUE 

ID2VAL 

14 

SETASG 

SETTPS 

SETUIC 

A6 

Value  associated  with  second 
method  of  identifying  ISSUE 

IE 

ISSFIN 

I 

Count  of  errors  found  in 
ISSFIN 

I  EOF 

GETPOL 

I 

If  set  to  1,  EOF  found  while 
reading  file 

IFILE 

REPT01 

REPT05 

REPT06 

REPT07 

REPT09 

REPT10 

REPT11 

I 

Logical  unit  number  of 
input  file 

A-10 


O. 
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CAA-D-84-2 


File  number 

Name 

or 

Format 

Description 

subroutine 

I  OK 

GETBAS 

I 

When  IOK  not  equal  to  z< 

GETJOB 

program  cannot  continue 

WRTVAL 

SETPOL 

MATPOL 

SETTPS 

SETUIC 

SETASG 

SETMOS 

AGGCHK 

AGISPO 

GETPAR 

SRTPOL 

ISMO 

WRTEXT 

FINVAL 

GETPOL 

DOIT 

WRTUNF 

GETVAL 


ISCRAT 

72 

12 

Overall  C-rating  based  on 
lowest  of  REAVC,  REASC,  AVSEC 
and  OKMOSC 

ISH 

GETWCT 

I 

Hour  of  start  time  for  this 
computation 

ISM 

GETWCT 

I 

Minute  of  start  time  for  this 
computation 

ISS 

GETWCT 

I 

Second  of  start  time  for  this 
computation 

ISSEOF 

ISSFIN 

I 

ISSUE  file  end  of  file  flag 

ISSNAM 

14 

A13 

Name  of  ISSUE  for  report 
processor 

A-ll 


CAA-D-84-2 


File  number 
or 

subroutine 


Format 


Description 


Name 


ISSUE 


l 

I 

I 


» 


OMOS 

LENG 


14 

19 

24 

25 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

50 

51 

52 

53 
61 
62 

63 

64 

65 

66 
67 
70 

72 

73 

74 

85 

86 

90 

91 

92 

39 

40 

CHKNUM 


A4  ISSUE  identification 


A9  Job  MOS 


I  Length  of  CHKFIE 

Numbers  of  characters  to  be 
converted  to  integer  or  real 
number 


LENGTH 


ICHINT 

RCHFLT 


I 


CAA-D -84-2 


Name 

File  number 
or 

Format 

Description 

LIC 

subroutine 

26 

A2 

Language  identifier  code 

LOCCO 

27 

28 

29 

30 

31 

36 

37 

38 

14 

A3 

Location  code 

LOGRAD 

22 

23 

24 

25 

32 

A2 

Lowest  grade  to  which  policy 

LUNIN 

33 

34 

35 

39 

40 

91 

92 

DOITNO 

I 

applies 

Logical  unit  for  input 

LUNISS 

D0IT12 

ISSFIN 

I 

Logical  unit  number  of  ISSUE 

LUNOUT 

DOITNO 

I 

file 

Logical  unit  for  output 

LUVIN 

D0IT12 

FINVAL 

I 

Logical  unit  for  reading  JAV 

LUVOUT 

FINVAL 

I 

records 

Logical  unit  for  reading  JAV 

records 

MISGOA 


70 


16 


Missed  goal  -  authorized 
strength 


CAA-D-84-2 


File  number 
or 

subroutine 


Format 


Description 


Name 


MISGOR 

70 

16 

Missed  goal  -  required 
strength 

MOS 

8 

21 

A9 

MOS  or  specialty  code 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

50 

51 

52 

53 

54 

64 

65 

66 
74 

91 

92 


10SACT 

61 

62 

A9 

Actual  MOS  filling  demand 

63 

10SFRM 

17 

A9 

MOS  from  which  to  make 

substitutions 

I0SREQ 

61 
r  r\ 

A9 

MOS  required  for  demand 

Name 

File  number 
or 

subroutine 

Format 

Description 

MOSSUB 

17 

A3 

MOS  substitution  (yes/no) 

MOSTO 

17 

A9 

MOS  to  which  substitution 
is  to  be  made 

MPERAU 

74 

F7.1 

AGASMO  divided  by  AGAVMO 
multiplied  by  100 

MPERRE 

74 

F7.1 

AGAVMO  divided  by  AGREMO 
multiplied  by  100 

NCCHAR 

17 

A6 

Number  of  characters  in  MOS 

NCCHWO 

17 

A6 

Number  of  characters  in 
warrant  officer  MOS 

NENUS 

21 

17 

Total  number  of  enlisted 
personnel  grades  El  through 

E9 

NERR 

WRTERR 

I 

Error  number  found  in 
Preprocessor,  Policy  Processor, 
or  Report  Processor 

NEWPOL 

GETPOL 

A80 

Area  into  which  a  policy  is 
read  and  stored  until  needed 

NE1 

21 

17 

Number  of  El  personnel 

NE2 

21 

17 

Number  of  E2  personnel 

NE3 

21 

17 

As  of  September  1983,  the 
sum  of  El,  E2,  and  E3 
personnel 

NE4 

21 

17 

Number  of  E4  personnel 

NE5 

21 

17 

Number  of  E5  personnel 

NE6 

21 

17 

Number  of  E6  personnel 

NE7 

21 

11 

Number  of  E7  personnel 

Number  of  E8  personnel 


NE8 


21 


17 


CAA-D-84-2 


File  number 

Name 

or 

Format 

Description 

subroutine 

NE9 

21 

17 

Number  of  E9  personnel 

NGRADE 

17 

12 

Number  of  separate  grades 

NOFF 

21 

17 

Number  of  officers 

NOl 

21 

17 

Number  of  officers  in  grade 
01 

N02 

21 

17 

Total  number  of  officers  in 
grades  01  and  02 

N03 

21 

17 

Number  of  officers  in  grade 
03 

N04 

21 

17 

Number  of  officers  in  grade 
04 

N05 

21 

17 

Number  of  officers  in  grade 
05 

N06 

21 

17 

Number  of  officers  in  grade 
06 

NUMEXC 

41 

1614 

Number  of  unassigned 

42 

personnel  by  grade 

43 

44 

NUMPER 

70 

16 

MINPER  times  aggregate 
assigned  strength 

NUMUNF 

50 

15 

Number  of  unfilled  jobs  by 

51 

job 

52 

53 

54 

NWO 

21 

17 

Number  of  warrant  officers 

OFFSUB 

17 

A3 

Officer  level  substitution 
(yes/no) 

OKMOSC 

72 

12 

C-rating  based  on  APREOK 

(correct  MOS) 


A-16 


Name 


File  lumber 
or 

subroutine 


Format 


Description 


PARAM 

17 

A6 

Alphanumeric  of  1  to  6 
characters 

PEAUGR 

73 

F7.1 

AGASGR  divided  by  AGAUER— 
multiplied  by  100 

PEREGR 

73 

F7.1 

AVAVGR  divided  by  AGREGR— 
multiplied  by  100 

PERIND 

90 

F5.3 

Percentages  for  each  grade 

PERMAX 

19 

32 

33 

34 

35 

70 

91 

92 

F5.3 

Maximum  percent  fill 

PERMIN 

19 

32 

33 

34 

35 

70 

91 

92 

F5.3 

Minimum  percent  fill 

POITYP 

32 

33 

34 

35 

91 

92 

A5 

Policy  type  -  either 

ISSUE  or  MOSSC 

REASC 

72 

12 

C-rating  based  on  REASEP 
(aggregate) 

REASPE 

72 

F7.1 

Aggregated  assigned  strength 
divided  by  aggregated  required 
strength 

CAA-D-84-2 


File  number 

Name 

or 

Format 

Description 

subroutine 

REAVC 

72 

12 

C-rating  based  on  REAVPE 
(aggregate) 

REAVPE 

72 

F7.1 

Aggregated  available  strength 
divided  by  aggregated  required 

strength 

REPNAM 

93 

A61 

Report  name 

REPNUM 

93 

A2 

Report  number 

REQSTR 

8 

13 

Required  strength 

26 

13 

27 

13 

28 

13 

29 

14 

30 

14 

31 

16 

36 

16 

37 

16 

38 

16 

RMOSC 

74 

12 

C-rating  based  on  required 

RUNDAY 

GETDAY 

A 

Rundate 

SCSUB 

17 

A3 

Specialty  code  substitution 
(yes/no) 

STACO 

14 

A5 

Station  code 

22 

23 

24 

25 

STNNM  22  A9  Station  name 

23 

24 

25 


STSAGG  22  14  Required  strength  -  aggregate 

23 

24 

25 


A-18 


CAA-D-84-2 


File  number 
or 

subroutine 


Format 


Description 


STSCIV 


Required  strength  -  civilian 


STSENL 


Required  strength  -  enlisted 


STSOFF 


Required  strength  -  officer 


STSWOF 


Required  strength  -  warrant 
officers 


i  !• 


Troop  program  sequence  number 


TYPCO 


Unit  type 


TYPSTR 


Type  strength  (REQ/AUT) 


UIC  code 


UIC26 


Characters  2-6  of  UIC 


. 


Name 


File  number 
or 

subroutine 


Format 


Description 


UNTDS 

22 

23 

24 

25 

A21 

Unit  description 

USEASI 

17 

A3 

Use  additional  skill  (yes/no) 

USEGRA 

17 

A3 

Use  pay  grade  (yes/no) 

USEGRD 

90 

11 

Indicator  of  inclusion 

USEIDE 

17 

A3 

Use  person  (sex/grade) 

IDENT  (yes/no) 

USELIC 

17 

A3 

Use  language  code  (yes/no) 

USEMOS 

17 

A3 

Use  MOS  or  SC  (yes/no) 

VALGRD 

90 

13 

Value  of  assignment  at  this 
grade 

VALUE 

19 

32 

33 

34 

35 

91 

92 

13 

Fill  value  of  each  job  up  to 
minimum  percentage 

VALUE2 

19 

13 

Value  of  filling  job  above 
minimum  percentage  up  to 
maximum  percentage 

VALGRD 

90 

13 

Value  of  assignment  to  this 
grade 

WHICH 

93 

A12 

Which  report  subtype 

YES/NO 

93 

A3 

"Yes"  or  "No"  for  print  of 
report  numbered  REPNUM 

APPENDIX  B 


COMMON  DOCUMENTATION 


POLICY  PROC 

Stored  in:  PFPRIM-SYMB.PRIM-PROCS 

Obtained  by:  INCLUDE  POLICY  (FORTRAN  statement) 

Ccxmton  Name:  POLCOM 

Used  by:  Policy  Processor  Only 


Variable 

Dim 

Fmt 

Length 

Description 

ADDON 

29 

A 

1 

All  characters  of  the  alphabet  plus 
blank  and  the  numbers  1  and  2.  Used 
for  creating  unique  demand  node  name'- 

AGGFIL 

1 

I 

Desired  aggregate  fill 

AGGMAX 

1 

I 

Desired  aggregate  maximum  fill 

AGGMIN 

1 

I 

Desired  aggregate  minimum  fill 

AGGVAL 

1 

I 

Value  of  making  each  assignment  up  to 
AGGMAX 

AGINO 

9,3 

I 

Policy  indicators  for  aggregate  records. 

The  first  dimension  is  one  greater  than 
the  maximum  possible  number  of  different 
policy  statements  that  could  be  input 
about  aggregates  within  one  ISSUE,  MOS, 
or  combination 

(1.1)  The  location  of  the  lowest  grade 
to  which  this  policy  applies 

(1.2)  The  location  of  the  highest 
grade  to  which  this  policy  applies 

(1.3)  The  value  of  each  assignment 
made  under  this  policy 

AGPER  8,2  R  Percentages  converted  to  decimal  from 

the  Policy  file  for  the  aggregate 
policies.  The  8  is  the  maximum  possible 
number  of  different  policy  statements 
that  could  be  input  about  aggregates 

(1.1)  The  minimum  percentage  of  desired 
fill  that  may  be  assigned 

(1.2)  The  maximum  percentage  of  desired 
fill  that  may  be  assigned 


Variable 

Dim 

Frat 

Length 

Description 

AGRADE 

16 

A 

2 

The  alpha  representation  of  valid 
grades--obtained  from  the  Parameter 
file 

ASDATE 

1 

A 

6 

The  as  of  date  from  the  Parameter  file 

BASVAL 

1 

A 

80 

The  area  a  value  record  (file  19) 
is  first  read  into 

BLNKl 

1 

A 

1 

An  alpha  filled  with  blanks  for 
length  =  1 

BLNK4 

1 

A 

4 

An  alpha  filled  with  blanks  for 
length  =  4 

BLNK5 

1 

A 

5 

An  alpha  filled  with  blanks  for 
length  =  5 

BLNK9 

1 

A 

9 

An  alpha  filled  with  blanks  for 
length  =  9 

8LNK10 

1 

A 

10 

An  alpha  filled  with  blanks  for 
length  =  10 

CMF 

1 

A 

2 

Career  management  field 

COMPUT 

16 

I 

An  indicator,  one  for  each  grade,  of 
whether  a  policy  has  been  previously 
input  for  this  g^ade 

DEMAN 

1 

A 

10 

Demand  node  name.  Created  from  the 

ISSUE  code  (first  four  characters)  and 
a  unique  combination  of  alpha  characters 
in  locations  5,  6,  and  7,  plus  alpha 
or  1  or  2  in  location  8.  The  method  of 
creating  DEMAN  limits  the  number  of  MOS 
per  issue  to  676. 

DIDISS 

1 

A 

4 

Set  to  the  ISSUE  which  policy  indicators 
were  last  set  for 

DIDMOS 

1 

A 

9 

Set  to  the  MOS  which  policy  indicators 
were  last  set  for 

E22ISS 

1 

A 

4 

The  ISSUE  code  for  which  error  22  was 
last  output.  This  is  used  to  keep 
from  generating  the  same  error  more  than 
once. 

CAA-SR-84-5 


Variable  Dim  Fmt  Length 


Description 


E26ISS 

1 

A 

4  The  ISSUE  code  for  which  error  26  was 

last  output.  This  is  used  to  keep 
from  generating  the  same  error  more  than 
once. 

E46ISS 

1 

A 

4  The  ISSUE  code  for  which  error  46  was 

last  output.  This  is  used  to  keep 
from  generating  the  same  error  more  than 
once. 

GRAF  I L 

16 

I 

The  desired  fill  for  each  grade 

GRAMAX 

16 

I 

The  maximum  fill  for  each  grade 

GRAM IN 

16 

I 

The  minimum  fill  for  each  grade 

GRAVAL 

16 

I 

The  value  of  each  assignment  for  each 
grade.  GRAVAL  is  set  from  VALGRD  and 
is  the  value  output  to  the  Job  Assign¬ 
ment  Value  (JAV)  file. 

I  COMP 

1 

I 

The  number  of  characters  of  ISSUE  on 
which  the  ISSUE  should  be  compared. 

For  the  aggregated-ISSUE  indicators, 
only  the  first  character  is  signifi¬ 
cant.  Dashes  (  — )  represent  place 
holders  instead  of  exact  characters 

I  EOF 

1 

I 

End-of-file  (on  Policy  file)  indicator 

IDEBUG 

•  1 

I 

A  flag  controlling  the  amount  of  debug 
printout  that  will  be  produced 

I GOT IT 

1 

I 

A  flag  indicating  that  memory  has  "got" 
a  job  record  that  cannot  be  matched 
with  a  policy  record.  The  job  record 
should  be  written  to  the  Extra  Job 

Data  file 

IGOTP 


1 


I 


A  flag  indicating  that  memory  has 
already  "got"  a  policy  and  is  waiting 
for  a  job  record  for  comparison 


Variable 

Dim 

Fmt 

Length 

Description 

IFLAG 

1 

I 

A  flag  controlling  the  path  used  by 
the  subroutine  FINDAT 

If  IFLAG  =  1,  the  policy  is  an 

ISSUE  policy 

If  IFLAG  =  2,  the  policy  is  a  combined 
ISSUE  and  MOS  policy 

If  IFLAG  =  3,  the  policy  is  an  MOS 
policy 

INDGRD 

16 

I 

An  indicator,  one  for  each  grade,  that 
the  data  for  this  grade  in  this  job 
record  has  already  been  written  to  the 
JAV  file 

INJOB 

1 

I 

The  number  of  jobs  that  were  matched 
with  a  policy 

INPOL 

1 

I 

The  number  of  policy  records  read  in 

INVAL 

1 

I 

The  number  of  JAV  records  read  in 

ISSFIR 

1 

I 

The  number  of  the  first  characters  of 
ISSUE  that  should  be  used  to  compare 

ISTREN 

16,2 

I  - 

The  authorized  and  required  strength 
for  each  grade  from  the  job  record 

IUSE 

1 

I 

The  flag  that  indicates  which  strength 
(from  ISTREN)  will  be  the  desired  fill 
level 

IVAL 

1 

I 

The  number  of  new  JAV  records  written 
during  this  portion  of  the  policy 
processor 

JEOF 

1 

I 

The  indicator  of  end-of-file  (on  the  job 
record  file) 

JMOS 

1 

A 

9 

The  MOS  from  the  job  record 

KMOS 

1 

I 

The  location  of  the  first  character 
checked  after  a  place  holder  in  an 

MOS  policy 

KNTAGG 


1 


I 


The  number  of  aggregate  policy  records 
for  each  ISSUE  or  combined  ISSUE  and  MOS 


Variable 

Dim 

Frat 

Length 

Description 

KNTEXT 

1 

I 

The  count  of  the  number  of  records 
written  to  the  extra  job  file 

KNTJOB 

1 

I 

The  count  of  the  number  of  job  records 
read 

KNTUNF 

1 

I 

Count  of  the  number  of  unfilled  job 
records  written 

KNTVAL 

1 

I 

Count  of  the  total  number  of  JAV  records 
written  (includes  records  written  in 
previous  modules  as  well  as  this) 

LASTAG 

1 

I 

Number  of  different  aggregation  policies 
read  for  one  aggregated  issue  in  MATPOL 

LISSUE 

1 

A 

4 

The  ISSUE  code  from  the  last  policy 
record  used 

LMOS 

1 

A 

9 

The  MOS  from  the  last  policy  record 
processed 

LUNAGG 

1 

I 

The  logical  unit  number  for  the  aggre- 
gated-ISSUE  indicators 

LUNBAS 

1 

I 

The  logocal  unit  number  of  the 

Value  file  (19) 

LUNEXT 

1 

I 

• 

The  logical  unit  number  of  the  Extra 

Job  file  for  output  (35,  3b,  39,  or  38) 

LUNOOB 

1 

I 

The  logical  unit  number  of  the  input 
job  file.  The  LUNEXT  from  one  module 
becomes  the  LUNJOB  of  the  next  module 

LUNPOL 

1 

I 

The  logical  unit  number  of  the  input 
Policy  file  (92,  32,  33,  34,  or  35) 

LUNUNF 

1 

I 

The  logical  unit  number  of  the  output 
unfilled  job  file  (50) 

LUNVAl 

1 

I 

The  logical  unit  number  of  the  output 

JAV  file  (39  or  40) 

I4AXSUM 


1 


I 


The  sum  of  the  maximums  for  individual 
grades 


Variable 

Dim 

Fat 

Length 

Description 

MINSUM 

1 

I 

The  sum  of  the  minimums  for  individual 
grades 

MNEMON 

1 

A 

6 

An  alpha  for  reading  mnemonics  from  the 
Parameter  file 

NCCHAR 

1 

I 

The  number  of  characters  of  MOS  that  will 
be  used  for  matching  purposes.  This  is 
from  the  Parameter  file. 

NEEDAG 

1 

I 

A  flag  that  signals  whether  the  policy 
is  of  a  type  that  aggregated- ISSUE  in¬ 
dicators  should  be  looked  for 

NEEDP 

1 

I 

A  flag  that  signals  whether  there  is  a 
policy  in  memory  that  needs  to  go  through 
SETPOL 

NGRADE 

1 

I 

The  number  of  valid  grade  codes  in  input 
data.  This  is  from  the  Parameter  file 

NEWPOL 

1 

A 

80 

The  area  into  which  a  new  policy  is  read 

NMOS 

1 

I 

The  number  of  characters  checked  prior 
to  a  place  holder  in  an  MOS  Policy.  If 
a  place  holder  was  not  used,  NMOS  equals 
NCCHAR  from  the  Parameter  file 

NOMAT 

1 

I 

A  flag  that  no  match  was  found  between 
the  present  policy  and  the  aggregated 
ISSUE  indicators 

NREC 

1 

I 

The  number  of  aggregated  records  written 
for  each  input  record 

NXT5 

1 

I 

A  flag  for  which  letter  of  the  alphabet 
(stored  in  ADDON)  was  last  put  into 
character  5 

NXT6 

1 

I 

A  flag  for  which  letter  of  the  alphabet 
(stored  in  ADDON)  was  last  put  into 
character  6 

NXT7 


1 


I 


A  flag  for  which  letter  of  the  alphabet 
(stored  in  ADDON)  was  last  put  into 
character  7 
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Variable 

Dim 

Fmt 

Length 

Description 

NXT8 

1 

I 

A  flag  for  which  letter  of  the  alphabet 
(stored  in  ADDON)  was  last  put  into 
character  8 

NXTAGG 

1 

I 

A  counter  of  which  set  of  aggregate 
indicators  is  now  being  used 

NXTFLG 

1 

I 

A  flag  that  indicates  whether  the  extra 
characters  needed  for  a  DEMAN  (demand 
node  name)  are  for  the  first  output 
record  for  an  input,  and,  if  not, 
which  output  record  it  is 

PERIND 

16,2 

R 

The  percentages  of  desired  fill  for 
each  grade 

(1.1)  =  the  minimum  percentage  converted 
to  decimal 

(1.2)  =  the  maximum  percentage  converted 
to  decimal 

PISSUE 

1 

A 

4 

The  ISSUE  from  the  policy  record  not  yet 
processed 

PMOS 

1 

A 

9 

The  MOS  from  the  policy  record  not 
yet  processed 

USEGRD 

16 

I 

A  flag  that  the  grade  has  already  been 
included  in  an  aggregation,  one  for 
each  grade. 

VALGRD 

16 

I 

The  value  associated  with  each  grade 
set  in  SETPOL 

YES 

1 

A 

3 

The  value  "YES"  for  checking  for 
aggregates 

Z4 

1 

A 

4 

An  alpha  containing  the  letter  Z 
repeated  four  times 

ZER02 

1 

A 

2 

An  alpha  containing  two  alpha 
zeros  ('00') 

B-7 
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SETCOM 


Stored  in:  PFPRIM-SYMB.PRIM-PROCS 

Obtained  by:  INCLUDE  SETPRO  (FORTRAN  statement) 

Common  Name:  SETCOM 

Used  by:  SET  ISSUE,  PROCESS  1-2  only 


Variable 

Dim 

Fmt 

Length 

AUSAGG 

1 

I 

AUSCIV 

1 

I 

AUSENL 

1 

I 

AUSOFF 

1 

I 

AUSWOF 

1 

I 

BLNK1 

1 

A 

1 

BLNK2 

1 

A 

2 

BLNK3 

1 

A 

3 

BLNK4 

1 

A 

4 

BLNK5 

1 

A 

5 

BLNK6 

1 

A 

6 

IDASGM 

1 

A 

6 

IDLOCC 

1 

A 

6 

IDSTAG 

1 

A 

6 

IDTPSN 

I 

A 

b 

Description 


Authorized  aggregate  strength 

Authorized  civilian  strength 

Authorized  enlisted  strength 

Authorized  officer  strength 

Authorized  warrant  officer  strength 

An  alpha  filled  with  blanks  for 
length  =  1 

An  alpha  filled  with  blanks  for 
length  =  2 

An  alpha  filled  with  blanks  for 
length  *  3 

An  alpha  filled  with  blanks  for 
length  =  4 

An  alpha  filled  with  blanks  for 
length  =  5 

An  alpha  filled  with  blanks  for 
length  =  6 

Alpha  =  "ASGMT  "  for  checking  ID1  and 
ID2  from  ISSUE  Definition  file 

Alpha  =  "LOCCO  "  for  checking  ID1  and 
ID2  from  ISSUE  Definition  file 

Alpha  =  "STACCO"  for  checking  ID1  and 
ID2  from  ISSUE  Definition  file 

Alpha  =  "TPSN  "  for  checking  ID1  and 
ID2  from  ISSUE  Definition  file 


Variable 

Dim 

Fmt 

Length 

Description 

ISSNAM 

1 

A 

12 

ISSUE  name  from  ISSUE  Definition  file 

LUNIN 

1 

I 

Logical  unit  number  to  use  for  next  input 

LUNOUT 

1 

I 

Logical  unit  number  to  use  for  next 
output  of  the  UlC-data  file 

LUNISS 

1 

I 

Logical  unit  number  to  use  for  ISSUE 
Definition  file  (14) 

NUIC 

1 

I 

Number  of  UIC  records  read 

NUMASG 

1 

I 

Number  of  ISSUES  set  on  the  basis  of 
ASGMT1  or  ASGMT 

NUMTPS 

1 

I 

Number  of  ISSUES  set  on  the  basis  of 

TPSN 

NUMUIC 

1 

I 

Number  of  ISSUES  set  on  the  basis  of  UIC 

NUMSET 

1 

I 

Total  number  of  ISSUEs  set 

TYPCO 

1 

A 

1 

Unit  type 

UNTUS 

1 

A 

21 

Unit  description 

AGGCOM 


Stored  in:  PFPRIH-SYMB.PRIM-PROCS 

Obtained  by:  INCLUDE  AGGREG  (FORTRAN  statement) 

Common  Name:  AGGCOM 

Used  by:  SET  ISSUE,  Process  1-2  only 


Variable 

Dim 

Fmt 

Length 

Description 

AS  I 

16 

A 

2 

ASI  code  from  MOS  record 

ASSSTR 

16 

I 

Assigned  strength 

AUTSTR 

16 

I 

Authorized  strength  from  the  MOS-data 
file 

GRAD16 

16 

A 

2 

Alpha  representation  of  each  grade 
from  Parameter  file 

Variable 

Dim 

Fmt 

Length 

Description 

IDENT 

16 

I 

Person  identity  code,  one  for  each 
grade 

LIC 

16 

I 

Language  identification  code,  one  for 
each  grade 

MOSIN 

1 

I 

Unit  number  for  reading  the  input  MOS- 
data  file 

MOSOUT 

1 

I 

Unit  number  for  writing  the  output  MOS 
data 

REQSTR 

16 

I 

Required  or  structure  strength  from  the 
MOS-data  file 

UIC24 

1 

A 

3 

Characters  2  through  4  of  the  UIC  from 
the  UlC-data  file 

U I CMOS 

1 

A 

6 

The  UIC  from  the  MOS-data  file  record 

UM0S24 

1 

A 

3 

Characters  2  through  4  of  the  UIC  from 
the  MOS-data  file  record 

ERROR  PROC 

Stored  in:  PFPRIH-SYMB.PRIM-PROCS 

Obtained  by:  INCLUDE  ERROR  (FORTRAN  statement) 

Common  name:  ERRCOM 

Used  by:  Preprocessor,  Policy  Processor,  and  Report  Processor  to  pass 
information  to  the  write  error  subroutine  (WRTERR) 


Variable 

Dim 

Fmt 

Length 

Description 

AGG 

1 

A 

2 

Whether  policy  is  aggregated  or  not, 

YE  =  YES,  NO  =  NO 

AS  GMT 

1 

A 

2 

A  code  representing  the  organization  to 
which  the  unit  belongs.  May  be,  but  no 
necessarily,  the  major  command 

GRADE 

1 

A 

2 

An  alphanumeric  code  for  the  pay  grade 
from  El  through  06 

GRDFRM 

1 

A 

2 

Pay  grade  code  that  the  grade  substitu¬ 
tion  is  from 

I 
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Variable 

Dim 

Frat 

Length 

Description 

pi 

GRDTO 

1 

A 

2 

Pay  grade  code  that  the  grade  substuti- 
tion  is  to 

-■ 

HI GRAD 

1 

A 

2 

Highest  pay  grade  on  policy  record 

1 

101 

1 

A 

6 

ISSUE  identification  method  one  (TPSN, 

STACO,  etc.) 

ID1VAL 

1 

A 

6 

Value  of  ISSUE  identification  method  one 

p 

102 

1 

A 

6 

ISSUE  identification  method  two  (STACO, 

ASGMT,  etc.) 

- 

' 

ID2VAL 

1 

A 

6 

Value  of  ISSUE  identification  method  two 

INTEG1 

1 

I 

Variable  for  passing  an  integer  to  WRTERR 

-* 

• 

INTEG2 

1 

I 

Variable  for  passing  a  second  integer 
to  WRTERR 

- 

- 

s  *• 

ISSUE 

1 

A 

4 

An  alphanumeric  code  for  the  ISSUE 
assigned  by  the  Preprocessor  using 
specifications  in  the  ISSUE  Definition 
file.  The  first  character  represents 
the  highest  (most)  aggregation,  charac¬ 
ters  two  and  three  represent  the  second 
aggregation  level 

— 

« 

JISSUE 

1 

A 

4 

The  ISSUE  code  from  the  job  file;  needed 
when  two  separate  files  contain  the 

ISSUE  code 

KERROR 

1 

I 

Humber  of  errors  written  by  WRTERR  - 
separate  count  for  each 

» 

KWARN 

1 

I 

Number  of  warnings  written  by  WRTERR 

LOCCO 

1 

A 

3 

Unit  location  code  -  from  the  UlC-data 
file 

• 

LOGRAD 

1 

A 

2 

Lowest  grade  on  policy  record 

■-' 

r 

r.' 

LUNIT 

1 

I 

Logical  unit  number  to  which  the  message 
applies 

MSCFRM 

1 

A 

9 

The  MOS  the  MOS  substitution  is  from 

8-11 
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Variable 

Dim  Fmt 

Length 

Description 

;  '■) 

1 

MSCTO 

1  A 

9 

The  MOS  the  MOS  substitution  is  to 

. ; 

MOS 

1  A 

9 

Military  occupational  specialty.  In 

PRIM,  the  officer  specialty  code  is 
also  called  MOS 

i 

NERROR 

1  I 

Total  number  of  errors  plus  warning 
messages 

a 

NFATAL 

1  I 

Meant  to  be  the  number  of  fatal  errors 
-  at  implementation  time,  no  errors  had 
been  identified  for  which  it  were  possible 
to  continue  present  processing  but  not 
continue  to  the  next  module.  All  errors 
either  made  it  impossible  to  continue 
this  module,  or  could,  under  some  cir¬ 
cumstance,  not  be  considered  fatal 

-  : 

» 

NTOTAL 

1  I 

If  NFATAL  is  greater  than  zero,  then 

NTOTAL  would  be  NERROR  plus  NFATAL  - 
the  sum  of  all  error  and  warning 
messages 

a 

REPORT  PROC 

- 

a 

Stored  in:  PFPRIM-SYMB.PRIM-PROCS 

Obtained  by:  INCLUDE  REPORT  (FORTRAN  statement) 

Common  name:  Unnamed 

Used  by:  Report  Processor  Only 

• 

■  : 

Variable 

Dim  Fmt 

Length 

Description 

:•  ■■ 

» 

ASDATE 

1  A 

11 

Alpha  representation  of  date  as 

ODMMYY 

.  ■■ 

GRADlb 

16  A 

2 

Alpha  representation  of  valid  grades 

i 

NGRADE 

1  I 

Number  of  valid  grades 

- 

RUNDAY 

1  A 

9 

Alphanumeric  representation  of  date 
as  YYMMDD,  converted  to  DD  MMM  YY 

*.‘,v 
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APPENDIX  C 

USER  DEFINED  FILES  -  - 


•  .  • 


C.l  ISSUE  DEFINITION  FILE 

a.  Purpose.  The  ISSUE  Definition  file  specifies  the  unit  aggregation 
level  and  the  method  PRIM  will  use  to  locate  the  correct  units.  Two  addi¬ 
tional  aggregation  levels  are  specified  by  the  combinations  of  characters 
used  in  the  ISSUE  code. 

b.  ISSUE  Code  Development.  The  ISSUE  code  is  always  four  characters  as 
shown  in  the  example  ISSUE  Definition  file.  Figure  C-l.  The  first 
character  of  the  ISSUE  code  represents  the  highest  aggregation  level  that 
is  less  than  the  total  Army;  many  of  the  reports  provide  totals  for  every 
set  of  ISSUEs  that  have  the  same  first  character.  Readiness  reports 
containing  "Aggregated  ISSUE"  in  the  title  will  sum  all  data  with  the  same 
first  character  and  report  only  the  totals.  The  second  and  third 
characters  are  used  to  specify  a  second  aggregation  level.  When  ISSUEs 
share  the  same  first  three  characters  of  the  ISSUE  code,  they  will  be 
subtotaled  on  output  reports.  The  fourth  character  of  individual  ISSUEs 
that  do  not  belong  to  other  ISSUEs  at  the  second  level  should  be  the 
special  character  of  dash  (also  called  hyphen  or  minus).  A  graphic 
representation  of  this  hierarchy  is  shown  in  Figure  C-2.  In  the  example 
ISSUE  Definition  file,  CONUS  divisions  are  the  lowest  aggregation  level. 
Since  CONUS  divisions  are  in  specific  geographic  locations  (in  the  example 
location  is  the  second  level),  the  fourth  character  of  the  code  is 
alphabetic,  not  dash.  The  units  that  are  colocated  are  specified  with  the 
same  characters  1,  2,  and  3;  the  one  with  a  geographic  name  has  a  dash 

(-)  for  the  fourth  character,  and  that  name  will  be  used  as  a  title  for  the 
subtotals.  Included  in  that  ISSUE  will  be  nondivisional  units  and  TDAs 
that  are  located  there.  The  third  (highest)  aggregation  level  (in  the 
example  MACOM)  is  designated  by  the  first  character.  The  relationships 
between  the  aggregation  levels  of  the  example  are  shown  in  Figure  C-3.  The 
network  assignment  program  and  the  report  programs  need  a  name  for  the 
third  aggregation  level.  This  is  entered  in  the  file  by  placing  X00-(where 
X  stands  for  any  aggregation  desired;  the  example  uses  MACOMs  or  CONUS)  in 
the  ISSUE  code  space  and  the  desired  name  in  the  correct  space,  with  other 
fields  unspecified.  To  allow  programs  to  proceed,  the  programs  assign  an 
ISSUE  code  of  " - "  to  any  units  not  otherwise  assigned  an  ISSUE.  There¬ 
fore,  a  dummy  entry  for  both  the  XOO-and  the  " - "  has  been  included  in 

the  example. 

c.  Conditions  and  Requirements 

(1)  An  individual  ISSUE  may  contain  one  or  many  units. 

(2)  Different  numbers  of  units  may  be  in  each  ISSUE. 


C-l 


l 


t‘% 


(3)  A  PRIM  policy  will  be  applied  to  ISSUES,  not  to  individual  units. 
If  ISSUEs  are  defined  as  individual  units,  the  policy  will  be  indirectly 
applied  to  individual  units  by  being  applied  to  an  ISSUE  which  is  an  aggre¬ 
gate  of  one  unit  only. 


P  R  I 

H  I 

3  S  U  E 

1 

-n  i 

H  I 

L  Z 

IS  SUE =  -  30  - 
ISSUE- - 1  0 1  -U IC3 

Iu2r 

’  V 

N  A  M  £  =  M  0  UIC  ERROR 

:<ame=bl  ank-uic 

ISSl’o-  1 U 1 =U  IC  3 

* 

132- 

* 

NAMt-=3L  ANK-UIC 

IS;>l'£  =  C3C- 
1S3UL=C31“ID1=ASGMT 

=  S  A 

iDTr 

N AME=C0NUS  IOThER) 
NAME=ARMy  SECRETARY 

ISSUE=C 12-ID1-AS&PT 

=  S  F 

ID  2  - 

NtME=«RMY  STAFF 

IS3UE=C33-IQi=ASGMT 

=RC 

102- 

• 

NAME=US AREC 

ISSUE=CC4-IDi=ASGMT 

rM  A 

ID2r 

• 

NAME=US*A 

ISSUE=C05-ID1=A$GMT 

=  0  F 

13  2- 

z 

NAUE=0EFENSE  SCTIV 

issue=c:6-:di=a5gmt 

-  J  A 

102- 

z 

r,AMF.=JOINT  ACTIVITY 

IS5UE=C37-I0i=ASGMT 

:PC 

T  02- 

z 

NAME=MEPCO* 

ISSU£  =  Cr}fc-IDl=ASGMT 

rCM 

I02r 

z 

N  AM  E  =  C0**PUT  Eft  SYST 

IS;>Ut=CC'9-l31=A  S&MT 

=  SC 

TO?- 

z 

name=pallistic  mis 

ISSUE=Clu-I01=ASGMT: 

-X 

102  = 

z 

name=3arcom 

ISSl'c  =  CU-IDl=AS6MT 

rM  k 

13?- 

z 

fjAME=vDW 

ISSUE=C12-ID1=ASGMT 

rH$ 

I0?  = 

z 

name=me»lth  services 

IS  jUC-C 1 3  —  I Ol-A  S  G  M  T 

=  CC 

102  = 

z 

N#HE=ACC 

IS3U£=CI>,-IDIrA3GMT 

-A  S 

IDCr 

z 

N  A  M  £  =  I NSC  OM 

ISSl'E=C  15-1  JI-UIC3 

r  A  <4  A 

1 0  2r 

z 

(NAMc=0L0  GUARD 

ISSUE-CIo-lPl-L'IC3 

-3  5T 

IU?  = 

z 

name=site  r 

ISSIIE-C17-ID1-UIC3 

rCUM 

TO  2 - 

z 

uame=mow  MP  cc 

I S  SUE  =C  13-I01=ASGMT 

=  C  B 

132  = 

z 

NAME=rin 

ISSUE-CI9-1G1=ASGMT 

rAG 

I02r 

z 

name=adjuta\t  sr\ 

ISSUErC23-ID:=A3GMT 

=  C  E 

IC2- 

z 

NAME=rHT£F  OF  £MGR 

ISSUE-C21-ID1-ASGMT 

rCS 

102  = 

z 

NAME=CHl£F  of  staff 

I3SUE-C22-IU1-AS&MT 

rM  C 

10  2- 

z 

name=surg EON  gen 

IS3UE=C23-I01=ASGMT 

rM  p 

102=  * 

z 

,VAME=MILPERCc.N 

IS  SUE =  C24-ID  1  =  A SGMT 

rM  T 

Iu  2  = 

z 

iVAME=mTmc 

ISSUE-C2i-lUl-UIC3 

=C  YL 

102  = 

z 

NArtE=SPEC  mo  CO 

IS$UE=C?S-U)1=U:C3 

rCWB 

TO  2  = 

z 

N«Mt=SPfC  mp  CO 

IS  SUE=CCS-I rJ  1  =  U  IC 3 

=  C  4L 

102  = 

z 

MAME=SPEC  MP  CO 

ISSL'E-Cr5"Iul-UIC3 

r F  M4 

102  = 

z 

N  AM  £  =  SP  rC  CO 

IS  SL'E-C2u-ID1  -  A  SGMT 

-  A  U 

TO  2  = 

z 

MAME=ARmY  AUDIT 

ISSUE-C27-I 0l-ASGMT 

=  Gl? 

10  2  = 

z 

;-4AMl  =  NATL  guard  bu 

I  S  SUE  =E  'c  - 

NAM£=US AREUR 

ISSl!E=E3i-lDI  =  TPSN 

_p  -  ^  * 

—  O  -J  4 

132  = 

z 

SAM£=1ST 

ARM 

01  V 

ISSUL=E3.-ID1  =  T3S'J 

=3220? 

102  = 

z 

N AME=3RP 

ARM 

oi  v 

ISSU:=E33-I 01 =  T°SN 

=3403= 

io  ?  = 

Z 

NAMl=^Tm 

INF 

niv 

I$3UE=E"4-I Ji=T?SN 

=Q4CQ? 

10?  = 

z 

\AKE  =  3Rr> 

I  NF 

01  V 

ISSI'2=El.S-ID1=A  SGMT 

=  E  H 

1 32  = 

z 

f4  A  M  E  r  E  &  T  h 

F  A 

BG  r 

IS  Gl.’i  =1  99-1  31  =  A  SGMT  1 

=  E 

ID2  = 

z 

wame=otne 

R  US 'ft  EUR 

ISSUE =L993I 32  =TPSN 

=04234 

Iu2=A5GMT 

-Z  5 

name  =  **tm 

m-CH 

-EUR 

IS  SUi;=E99pI  JlrTPSN 

=2230? 

10  2  =  ASG M  T 

=  E  p 

NAME=2N0 

ARM- 

EU  3 

ISSl'ErE  ?9  Cl  D 1  =  T  PS 

=24201 

I0?=L0CCC 

=  GE 

NAME  =  1ST 

MECH 

-EUR 

Figure  C-l.  ISSUE  File  Example 


Level 


Aggregation  Hierarchy 


Figure  C-3.  Hierachy  of  Example 
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(4)  The  maximum  number  of  ISSUEs  that  may  be  defined  for  one  run  is 

300. 

(5)  A  PRIM  policy  may  apply  to  more  than  one  ISSUE  (See  Section  C.3 
Policy  file) 

(6)  If  necessary,  multiple  combinations  of  identification  methods  may 
be  used  for  each  ISSUE,  but  each  method  should  uniquely  identify  a  subset 
of  units. 

(7)  Units  may  not  be  included  in  more  than  one  ISSUE. 

(8)  All  units  should  be  included  in  an  ISSUE. 

d.  Data  Entries.  The  format  is  described  in  the  file  description  for 
file  14,  ISSUE  Definition  file.  The  unnamed  fields  such  as  "ISSUE="  must 
be  on  each  definition  record;  all  records  without  these  fields  will  be 
ignored.  ID1,  ID1VAL,  ID2,  ID2VAL,  and  ISSNAM  must  be  left  justified.  All 
fields  except  ID2  and  ID2VAL  are  required  as  described  below.  Valid 
combinations  of  ID1  and  ID2  are  shown  in  Table  C-l.  The  sequence  is  the 
processing  sequence,  and  the  reset  variable  indicates  whether  an  ISSUE  will 
be  reset  during  that  process  if  it  had  been  set  during  a  previous  process. 


Field 


Needed  for 


ISSUE  Code 

ID1 


ID1  Value 


ID2 


ID2  Value 


ISSUE  Name 


Data  aggregated  to  the  desired  level  is  labeled  with 
the  ISSUE  code. 

At  least  one  method  of  identification  must  be  pro¬ 
vided  for  each  ISSUE  code.  See  Table  C-l  for  the 
valid  combinations  of  IDl  and  ID2. 

In  addition  to  the  method,  one  or  more  specific 
values  which  are  unique  to  the  desired  units  must  be 
specified. 

A  second  identification  method  is  only  required  when 
it  is  impossible  to  uniquely  identify  the  units 
using  IDl.  If  it  is  not  needed,  this  field  may  be 
blank.  See  Table  C-l  for  valid  ID2  variables. 

When  a  second  identification  method  is  specified, 
the  associated  value(s)  must  also  be  specified.  If 
ID2  is  blank,  ID2  value  should  also  be  blank. 

The  report  programs  use  this  name  for  print 
purposes. 
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Table  C-l.  ISSUE  Identification  Methods 


Sequence 

ID1 

ID2 

Reset 

1 

TPSN 

ASGMT 

N/A 

2 

TPSN 

LOCCO 

Yes 

3 

TPSN 

STACO 

Yes 

4 

TPSN. 

- 

No 

5 

UIC3 

- 

Yes 

6 

AS  GMT 

LOCCO 

No 

7 

ASGMT 

STACCO 

No 

8 

AS  GMT 

- 

No 

9 

ASGMT1 

No 

C.Z  PARAMETER  FILE 

a.  Purfose.  The  Parameter  file  provides  the  user  with  maximum  flexibi¬ 
lity.  Much  of  the  program  logic  such  as  number  of  characters  desired  in  an 
MOS,  the  amount  of  assignment  substitution  allowed  and  the  cut-points  for 
readiness  ratings  is  controlled  by  entries  in  the  Parameter  file. 

b.  Conditions  and  Requirements 

(1)  All  variables  described  below  must  be  provided. 

(2)  Parameter  file  records  must  be  in  the  exact  format  described  in 
the  file  description  for  file  number  17,  Parameter  file.  An  example  of  the 
Parameter  file  is  shown  in  Figure  C-4.  Blank  records  or  comment  records 
may  be  added;  they  must  not  mimic  the  format  of  another  required  record. 

(3)  Except  for  the  relationship  between  NGRADE  and  the  valid  grade 
names,  the  Parameter  file  records  may  be  in  any  order. 

c.  Data  Entries.  This  section  provides  an  expanded  description  of  the 
data  required  for  record  type  1,  and  of  the  relationships  between  record 
type  1  and  record  type  2  or  3.  See  the  file  description  for  the  Parameter 
file  (file  17)  for  the  format  of  record  types  2  and  3.  All  entries  for 
record  type  1  and  for  record  type  2  are  required;  record  type  3  is  required 
only  when  assignment  substitution  is  requested. 
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PRIM  PARAMETER  FILE 


=  0609  30 


AS  OF  DATE  TO  SELECT  FROM  AUTHORIZATIONS 
SELECTION  L06IC  IS:  TDATE  <  ASOF  <r  EDATe 


NGRAOE  =  1 


NUMBER  OF  DISTINCT  GRADES  ON  INVENTORY  DATA 


LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 

LOCATION 


OF  El 
OF  E2 
OF  E  3 
OF  E  9 
OF  E5 
OF  E6 
OF  ET 
OF  EB 
OF  E9 
OF  MO 
OF  01 
OF  OZ 
OF  0  3 
OF  09 
OF  05 
OF  06 


IN  GRADE- 
IN  GRADE- 
IN  GRADE- 
IN  GRADE- 
IN  GRADE- 
IN  GRAOE- 
1N  GRADE- 
IN  GRAOE- 
IN  GRADE- 
IN  GRADE- 
IN  GRAOE- 
1 N  GRADE- 
IN  GRADE- 
IN  GRADE- 
IN  GRADE- 
IN  GRADE- 


NCHFNL=3:  NUMBER  OF  MOS  CHARACTERS  TO  AGGREGATE  -  ENLISTED  ONLY 

NC  HWOF  z  9  :  NUMBEP  OF  MOS  CHARACTERS  TO  AGGREGATE  -  WARRANT  OFFICERS  ON 

NC HOF F=  2 :  NUMBER  OF  MOS  CHARACTERS  TO  AGGREGATE  -  OFFICERS  ONLY 

NCCHARzM:  NUMBER  OF  MOS  CHARACTERS  FOR  MATCHING  *MAX=9»  -  USE  LARGEST 

MOSPEO=9l  INPUT  EXCESS  PEOPLE  FILE  FOR  MOS  SUBSTITION 

MO S JOB  =  5 1  INPUT  UNFILLED  JOB  FILE  FOR  MOS  SUBSTITUTION 

GRDPEOrOl  INPUT  EXCESS  PEOPLE  FILE  FOR  GRADE  SUBSTITUTION 

GR0J0P,  =  S1  INPUT  UNFILLED  JOB  FILE  FOR  GRADE  SUBSTITUTION 


N0N*VA=.Q5 


NONAVAILABILITY  RATE  FOR  REAOINESS  PROCESSOR 


MO  SSUB  =  YE  S 
C 

FROM: 

SC  OSUB  =N0  : 


MOS  SUB  ALLOWED  -  F ORMA T f 7X , A  5, A9 ,6X , A  3 , A9 1 
IB  T0=1008 

SPECIALTY  CODE  SUBSTITUTION  ALLOWED 


ENLSUB=YES  ENLISTEO  GRAOE  SUB  ALLOWED 

FROM  rt  3  TO  =E  9 

FR0M=E9  TO  =E  5 

FROM  z£  5  TO  =  E  6 

FR0MrE6  T0  =  £7 

FR  OM -E  7  TO  =  E  8 

FROMrEB  TO  =  E  9 


OF  F  SUB  =  YE  S : 


FRCMrOZ 
rR0M=03 
FROM  =0  9 
F  R  OM  -  0  5 


OFFICER  GRAnE  SUB  ALLOWEO  F ORM AT t 7X , A  5, A2 f 1 ?X  ,  A  3 , A2 ) 


TO  =0  3 
TO  =  0  9 
TO  =  0  5 
TO  =0  6 


TYPSTR=AuT: 


USE  AUTHORI7E0  TAUT!  OR  REQUIRED  IREO)  STRENGTH? 


ClVALA=n.OOO: 
C2VALArQ.?D'J: 
cjv»LA=o.?oa: 
Cl VSLM30.850: 
C2V#LM=D. ’SO: 

c Jv*LM=n.fcsa: 


BREAK  B  ETWF.EN  C2  AND  Cl  RATINGS 
BREAK  BETWEEN  C3  AND  C2  RATINGS 
BREAK  BETWEEN  C9  ANO  C3  RATINGS 
BREAK  BETWEEN  C  2  ANO  Cl  RATINGS 
BREAK  BETWEEN  C  3  AND  C2  RATINGS 
BREAK  BETWEEN  CM  AND  CJ  RATINGS 


USED  FOR  AGGREGATES 
usro  FOR  AGGREGATES 
USED  FOR  AGGPEE-ATES 
USEO  FOR  MOS  t  HIGH  5 
USED  FOR  MOS  t  HIGH  5 
USED  FOR  MOS  l  HIGH  5 


Figure  C-4.  Parameter  File  Example 
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Columns 


Description 


1  8 
ASOF  =YYMMDD 


1  8 
NGRADE=nn 


1  8 
NCHENL=n 


1  8 
NCH0FF=n 


1  8 
NCHW0F=n 


1  8 
NCCHAR=n 


1  8 
MOSSUB=YES 
or 

M0SSUB=N0 


1  8 
SCUSUB=YES 
or 

SCDSU8=N0 


1  8 
ENLSUB=YES 
or 

ENLSUB=N0 


As  of  date  of  the  inventory  and  authorization  data, 
this  date  is  printed  on  the  formatted  reports. 


Two-digit  integer  representing  the  number  of  separately 
identified  grades  in  the  data.  The  largest  valid  inte¬ 
ger  is  16.  This  record  must  be  followed  by  one  blank 
or  consent  record  which  must  be  followed  by  at  least 
nn  type  2  records. 


The  number  of  characters  of  the  MOS  to  use  for 
enlisted  data;  maximum  value  is  9. 


The  number  of  characters  of  the  specialty  code  to  use 
for  officer  data;  maximum  value  is  9. 


The  number  of  characters  of  the  MOS  to  use  for  warrant 
officer  data;  maximum  value  is  9. 


Number  of  characters  PRIM  will  use  to  match  MOS  of 
people  against  MOS  of  job.  The  maximum  value  is  9; 
the  normal  setting  is  the  largest  of  NCHENL,  NCHOFF, 
and  NCHWOF .  However,  if  desired,  this  may  be  smaller 
than  any  of  the  three  other  values.  In  the  Assignment 
Processor  this  number  of  characters  will  be  used  for 
all  grades;  preprocessing  sets  all  characters  beyond 
NCHENL  and  NCHWOF  to  blank. 


Whether  MOS  substitution  will  be  allowed  on  this  run. 
If  the  value  is  "YES",  type  3  records  must  follow.  If 
the  value  is  "NO,"  all  of  the  type  3  records  following 
this  will  be  ignored. 


Whether  specialty  code  substitution  will  be  allowed. 

If  the  value  is  "YES",  type  3  records  must  follow.  If 
the  value  is  "NO,"  all  of  the  following  type  3  records 
will  be  ignored. 


Whether  enlisted  grade  substitution  will  be  allowed. 

As  for  MOSSUB  and  SCDSUB,  type  3  records  must  follow  a 
value  of  "YES"  and  will  be  ignored  following  a  "NO" 
value. 
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Columns 


Description 


ft 


1  8 

QFFSUB=YES 
or 

0FFSUB=N0 

1  8 

TYPSTR=AUT 
or 

TYPSTR=REQ 


1  8 
MOSPEOnn 


1  8 
M0SJ0B=nn 


1  8 
GRDPE0*nn 


1  8 
GRDJ0B=nn 


1  3 

N0NAVA=.nn 


1  8 
C1VALA= . XXX 


Whether  officers  grade  substitution  will  be  allowed. 
Type  3  records  must  follow  a  value  of  "YES"  and  will 
be  ignored  following  a  "NO"  value. 


A  value  of  "AUT"  means  the  authorized  strength  will 
be  used  for  developing  the  fill  levels;  a  value  of 
"REQ"  means  the  required  (structure)  strength  will  be 
used. 


The  file  number  for  input  of  excess  people  for  MOS 
substitution;  the  number  may  be  41  or  43.  Normally, 
41  is  used  when  MOS  substitution  is  run  immediately 
after  regular  assignment,  and  43  is  used  when  grade 
substitution  is  run  first. 


The  file  number  for  input  of  unfilled  jobs 
substitution;  the  number  may  be  51  or  53. 
is  41,  MOSJOB  should  be  51;  when  MOSPEO  is 
should  be  53. 


for  MOS 
When  MOSPEO 
43,  MOSOOB 


The  file  number  for  input  of  excess  people  for  grade 
substitution;  the  number  may  be  41  or  42.  Normally, 
41  is  used  when  grade  substitution  is  run  immediately 
after  regular  assignment,  and  42  is  used  when  MOS  sub 
stitution  is  run  prior  to  grade  substitution. 


The  file  number  for  input  of  unfilled  jobs  for  grade 
substitution;  the  number  may  be  51  or  52. 


The  percentage  of  assigned  personnel  not  available  for 
duty  converted  to  a  decimal  and  subtracted  from  1.00; 
could  be  considered  as  the  percentage  of  assigned  per¬ 
sonnel  who  will  be  available  for  duty  converted  to  a 
decimal  rate. 


The  break  between  C-2  and  C-l  rating  for  aggregate 
available  strengths  (page  3-11,  AR  220-1,  Unit  Status 
Reporting,  dated  1  June  81). 
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Columns 


Description 


1  8 
C2VALA=.XXX 


1  8 
C3VALA=.XXX 


1  8 
C1VALM=.XXX 


1  8 
C2VALM=.XXX 


1  8 
C3VALM=.XXX 


The  break  between  C-2  and  C-3  rating  for  aggregate 
available  strengths  (page  3-11,  AR  220-1,  Unit  Status 
Reporting,  dated  1  June  81). 


The  break  between  C-3  and  C-4  rating  for  aggregate 
available  strengths  (page  3-11,  AR  220-1,  Unit  Status 
Reporting,  dated  1  June  81). 


The  break  between  C-2  and  C-l  ratings  for  available 
MOS  or  senior  grade  percentage  (page  3-12,  AR-220-1, 
Unit  Status  Reporting,  dated  1  June  1981). 


The  break  between  C-3  and  C-2  ratings  for  available 
MOS  or  senior  grade  percentage  (page  3-12,  AR-220-1, 
Unit  Status  Reporting,  dated  1  June  1981). 


The  break  between  C-4  and  C-3  ratings  for  available 
MOS  or  senior  grade  percentage  (page  3-12,  AR-220-1, 
Unit  Status  Reporting,  dated  1  June  1981). 


C.3  POLICY  FILE 

a.  Purpose.  The  Policy  file  specifies  the  minimum  and  maximum  fill 
levels  and  the  associated  assignment  value  for  specific  grades  or  aggrega¬ 
tions  of  grades  in  specific  ISSUES,  specific  MOS  or  SC,  or  in  a  specific 
combination  of  ISSUE  and  MOS.  All  policies  which  are  related  to  specific 
MOS  or  SC  must  be  entered  in  this  file;  ISSUE  policies  that  apply  to  all 
grades  individually  may  be  entered  here  or  in  the  Value  file;  policies 
specified  in  terms  of  aggregations  should  be  entered  in  the  Policy  file; 
policies  that  do  not  apply  to  all  grades  must  be  specified  here  (see  Table 
C-2). 


b.  Conditions  and  Requirements 

(1)  All  ISSUE  codes  must  be  defined  in  the  ISSUE  Definition  file. 

(2)  The  same  grade  cannot  be  used  on  more  than  one  individual  grade 
record  or  in  more  than  one  aggregated  grade  record  for  an  ISSUE,  an  MOS  or 
SC,  or  a  specific  combination. 


Table  C-2.  Choice  of  Policy  or  Value 


Related  to 

Pay  grade 

File 

ISSUE 

Less  than  all 

Pol  icy 

ISSUE 

All,  aggregated 

Policy 

ISSUE 

All,  individually 

Pol  icy 
or  Value 

MOS 

Any  number,  both 
aggregated  and  not 

Pol  icy 

ISSUE  &  MOS 

Any  number,  both 
aggregated  and  not 

Pol  icy 

(3)  If  an  ISSUE-specif ic  policy  is  inconsistant  with  a  policy  stated 

for  the  including  aggragated-ISSUE,  the  ISSUE-specif ic  policy  will  be 
ignored;  an  error  message  will  be  given.  The  only  way  to  correct  this  type 

of  error  is  to  delete  the  ISSUE-specif ic  policy  or  to  delete  the  aggregated 

ISSUE  policy  and  replace  it  with  one  record  for  each  ISSUE  included  in  the 
aggregation,  except  the  one  that  would  otherwise  cause  the  error. 

(4)  A  warning  message  is  given  for  every  fill  percentage  greater  than 
200  percent  (2.000  in  decimal). 

(5)  Although  the  Value  file  is  not  compared  with  the  Policy  file,  the 

user  should  consider  both  files  when  setting  the  values  in  each.  In  general, 
Policy  file  values  should  probably  be  less  than  the  Value  file  minimum  fill 
values;  it  may  be  desirable  to  set  the  Policy  file  values  to  smaller  values 

than  the  Value  file  minimum  values  and  larger  than  the  Value  file  maximum 

values. 

(6)  When  a  policy  record  applies  to  fewer  grades  than  are  in  the  data, 
only  those  grades  specified  are  written  to  the  Job  Assignment  Value  file; 
the  data  for  other  grades  is  saved  for  the  application  of  other  policies  or 
the  Value  file. 

(7)  The  minimum  percentage  must  be  less  than  or  equal  to  the  maximum 
percentage. 

(8)  The  low  grade  must  be  less  than  or  equal  to  the  high  grade. 
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(9)  The  value  of  each  assignment  between  the  minimum  and  the  maximum 
will,  by  default,  be  the  same  as  the  value  for  each  assignment  up  to  the 
minimum. 

c.  Data  Entries.  All  entries  are  required  except  "IS$UE=XXXX"  for  MOS 
policies  and  "MOS=XXXXXXXXX"  for  ISSUE  policies.  For  correct  column 
numbers,  see  the  file  description  for  file  91,  Policy  file.  In  the  follow¬ 
ing  data  descriptions,  the  description  on  the  right  applies  to  the  X  value 
on  the  left.  An  example  of  a  Policy  file  will  be  found  in  Figure  C-5. 


Field 


ISSUE=XXXX 

or 

MOSSC=bbbb 


L0=XX 


HI=XX 


AG=XXX 


VALUE=XXX 


MIN=X.XXX 


MAX=X.XXX 


MOS=XXXXXXXXX 


Description 


For  ISSUE  policies,  this  is  a  valid,  four  character 
code  from  the  ISSUE  file;  the  ISSUE  code  is  blank  for 
MOS  policies. 

The  lowest  grade  to  which  this  policy  applies. 

The  highest  grade  to  which  this  policy  applies. 

If  the  policy  applies  only  to  the  aggregate  of  the  low 
grade  through  the  high  grade,  XXX  should  be  YES. 
Another  record(s)  should  be  input  whch  specifies  the 
policy  for  the  individual  grades.  On  those  records, 
XXX=N0b. 

The  value  or  worth  of  meeting  this  policy.  In 
general,  the  magnitude  of  the  policy  values  will  be 
larger  than  the  maximum  fill  value  in  the  Value  file. 
It  may  be  advantageous  to  set  the  minimum  fill  value 
in  the  Value  file  larger  than  this  policy  value.  The 
job  with  the  largest  value  will  be  filled  first. 

The  smallest  percentage  (converted  to  a  decimal)  of 
assignments  that  should  be  made  for  this  grade(s), 
ISSUE,  and/or  MOS. 

The  largest  percentage  of  assignments  that  may  be  made 
for  this  grade(s),  ISSUE,  and/or  MOS  (converted  to  a 
decimal ) . 

This  field  is  blank  for  ISSUE  policies;  otherwise,  it 
is  required.  Although  the  MOS  may  be  up  to  nine 
characters  in  length,  the  number  of  characters  should 
not  be  larger  than  the  number  of  characters  specified 
for  the  grade  in  the  Parameter  file. 


•  i 


•  9 
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PRIM  P 

0  L  I  C 

Y 

FILE 

- 

ISSUE:C01-L0:02HI:02AG  :N0 

V  ALUC - 

5 

HIM:  .70 

M*x: J  .90 

MOS: 

ARMY 

SECR 

ISStf£:C01-L0^03HI=0  34G:NO 

VALUE: 

5 

M I N -  1 . 00 

MAX:  1  • 10 

MOS: 

*  R  MY 

SECP 

ISSUE:C01-L0:04Hl:O6 AG:NO 

VALUE: 

5 

MIN=  .70 

MAX:l  .90 

MOS: 

ARMY 

SECR 

ISSUE :CO!-LO:wOHI:wOAG:NO 

VALUE: 

S 

MINrt.OO 

MAX:]. 10 

MOS: 

XRMY 

SFCP 

ISSUE :CQ2-L0:02HI:02AG:N0 

VALUE: 

5 

MIN:  .70 

MAX:l,90 

MOS: 

Army  STAF 

ISSUE :C02-L0:0JHI:03XG:N0 

VALUE : 

5 

M IN : I  .00 

MAX:  1.10 

MOS: 

ARMY  STAF 

ISSUE:CO2-LO:09Hi:06*G:N0 

VALUE: 

5 

MIN:  .70 

MAX:  1.90 

MOS  = 

ARMY  STAF 

ISSUE :C02-L0:W0HI:w0*G:N0 

VALUE: 

S 

M IN:  1 .00 

HAX:1.10 

HOS: 

ARMY  STAF 

ISSUE:C03-L0:E3HI:£9*G:YESY»LUE: 

s 

M IN: I  .00 

MAX :1 . 10 

MOS: 

USAREC 

ISSl’E:C03-LO:02Hl:02*G;M0 

VALUE: 

s 

MIN:  .70 

MAX:  1 ,90 

MOS: 

USAREC 

ISSUE:C03-L0:03HI:03*G :N0 

VALUE: 

b 

MIN:i.QO 

MAX :  1  • 10 

MOS: 

USAREC 

ISSU£:C03-EO:O4HI:O6»G:N0 

VALUE: 

5 

MIN:  .70 

MAX: 1 .90 

MOS: 

USAREC 

IS$ue:C03-L0:V0Hl:W0*G:N0 

VALUE: 

5 

MIN:i .00 

MAX:1.10 

HOS: 

USAREC 

1SSUE=CCM-L0:W0H1:06AG:N0 

VALUE: 

S 

MIN: I .00 

MAX:I.  10 

MOS: 

USMA 

ISSUE:C0S-L0:W0HI:06»G:NO 

VALUE: 

S 

M  IN:  1  ,00 

M AX : 1 . 10 

MOS: 

OErENSE  A 

I S  SUE : C06 -L  0:U0HI :06 AG  :N0 

VALUE: 

S 

MlN:i.on 

MAX :  1 . 10 

MOS: 

JOINT  ACT 

ISSUE:CO7-LO:02Hl:O2AG  =N0 

VALUE: 

5 

MIN:  .70 

MAX:  1.90 

MOS: 

MEPCOM 

ISSUE:C07-L0:03HI=03AG:N0 

VALUE: 

S 

M  I N  :  1  ,00 

MAX:}. 10 

MOS: 

MEPCOM 

ISSUE :C07-L0:0MHI:06 AG :N0 

VALUE: 

s 

MIN:  .70 

MAX: 1 .90 

MOS: 

MEPCOM 

ISSUE :C07-L0:U0HI:W0AG:N0 

VALUE: 

s 

M  IN: 1 ,00 

MAX:1.10 

MOS: 

MEPCOM 

ISSUE :C 08 -LO:02HI:O2AG:NO 

VALUE  - 

5 

MIN:  .70 

MAX: 1.90 

MOS: 

CMP  SYS  C 

ISSUE:C08-L0:02HI:06AG:K0 

VALUE: 

b 

MIN:l  .00 

MAX:1,}0 

S  C  :  5  3 

CMP  SYS/S 

1SSUE:C08-LO:03MI:03AG:NO 

VALUE: 

5 

HIN:l  .00 

MAX:!. to 

MOS  : 

CMP  SYS  C 

ISSUt:C08-LO:04HI:06AG:NO 

VALUE: 

b 

MJN:  .70 

M AX : 1 . 9Q 

MOS: 

CMP  SYS  C 

ISSUE :C 08 -LO:VOHI:WOAG :N0 

VALUE: 

b 

M  I N  :  1  .00 

MAX : i . 10 

M0S:7A1 A 

CMP  SYS/7 

ISSUE :C  09 -L  0 : VOHI :06  AG :N0 

VALUE: 

5 

MIN:1.00 

MAX: 1 . 10 

MOS: 

PAILIS  MI 

ISSUE:CIU-LO:O2MI:O6AG:N0 

VALUE  : 

5 

M  I N  : 1 • 00 

MAX:1. ID 

S  C  :  9  7 

PAPCOM/SC 

ISSl'E:ClU-LO:O2HI:O«>AG:N0 

VALUE: 

b 

MIN:1.0H 

MAX:  1  .  10 

S  C  :  S  1 

PARCOM/SC 

ISSUE :C15"L0:E3HI:E9AG: YE SVALUE: 

S 

MIN:  .97 

M AX : 1 ,  1 0 

MOS: 

OLD  GUARD 

ISSUE :Clb-L0:E3Hl:E9AG:YESVALUE: 

5 

M IN: I  .00 

MAX:  1.  10 

MOS: 

SITE  "R" 

IS  SUE  :C  17  *L  0:E3HI  :£9  AG  :YE  SV  ALUE  : 

5 

MIN:  .97 

MAX:1.10 

MOS: 

MOW  MP  CO 

Figure  C-5.  Policy  File  Example 
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C.4  VALUE  FILE 


a.  Purpose.  The  Value  file  specifies,  by  ISSUE,  the  minimum  and 
maximum  percentage  of  authorized  or  required  spaces  that  the  Assignment 
Processor  should  attempt  to  fill.  In  addition  to  the  value  for  filling  up 
to  minimum  fill  level,  a  value  for  filling  from  the  minimum  up  to  the 
maximum  is  specified.  An  example  of  a  Value  file  is  in  Figure  C-6. 

b.  Conditions  and  Requirements 

(1)  There  should  be  one  record  for  every  ISSUE,  but  no  more  than  one 
per  ISSUE. 

(2)  In  general,  the  value  of  filling  from  zero  to  the  minimum  should 
be  greater  than  the  value  of  filling  from  the  minimum  to  the  maximum. 

(3)  The  minimum  fill  value  may  be  equal  to  the  maximum  fill  value. 

(4)  The  Value  file  is  not  applied  to  data  for  which  a  valid  policy 
had  been  present.  In  other  words,  the  Policy  file  must  contain  the  largest 
desired  percentage  for  all  entries;  no  data  element  will  have  both  a  Policy 
file  record  and  a  Value  file  record  applied. 

c.  Oata  Entries.  All  entries  in  this  file  are  required.  For  the 
correct  columns,  see  the  file  description  for  file  19,  Value  file.  In  the 
following  data  descriptions,  the  description  on  the  right  applies  to  the  XX 
field  on  the  left. 


Entry 


ISSUE=XXXX 


MINIMUM=X.XXX 


MINVAL=XXX 


Description 


A  valid,  four-character  ISSUE  code  from  the  ISSUE 
file. 

Minimum  percentage  fill  converted  to  decimal.  The 
records  that  are  created  from  this  data  will  show  the 
minimum  and  maximum  fill  levels  both  equal  to  this 
rate  times  the  desired  fill  for  each  grade  level;  the 
aggregate  fill  levels  will  be  the  sum  of  the  grade 
fills. 

This  value  will  be  used  on  the  records  described  above 
for  MINIMUM.  This  is  normally  larger  than  MAXVAL  and 
may  be  larger  than  the  policy  values. 
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I 


I 


IS  SUE  = - MINIMUM: 

•  60 

m I Nv i L  : 

3 

MAXIMUM: 

.9 

MAX val: 

1 

ISSUE :  MINIMUM: 

.60 

minvAl: 

3 

MAXIMUM: 

.9 

max val: 

I 

I S  SUE :C01  -  MINIMUM: 

.90 

minval: 

V 

maximum: 

1.0 

MAX VAL= 

2 

ISSU£:C02-  MINIMUM: 

.70 

MINVAL: 

9 

maximum: 

1.0 

MAX  VAL: 

2 

I S  SUE :C 33 -  MINIMUM: 

.70 

MINVAL  : 

8 

maximum: 

1.2 

maxval: 

2 

ISSUE:C04-  minimum: 

.  70 

minval: 

9 

maximum: 

1.0 

MAX VAL: 

2 

IS  SUE :C  05  -  MINIMUM: 

.9? 

minval: 

4 

maximum: 

1  .0 

maxval: 

2 

I S  SUE: C  3b -  MINIMUM: 

.90 

minval: 

4 

MAXIMUM: 

l.C 

maxval: 

2 

IS  SUE :C07 -  MINIMUM: 

•  7C 

minval: 

4 

maximum: 

1.3 

maxval: 

2 

ISSUE:C08-  MINIMUM: 

.70 

minval: 

4 

MAXIMUM: 

1.0 

maxval: 

2 

I S SUE  =  C 09 -  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

ISSUErClC-  MINIMUM: 

.70 

minval: 

4 

maximum: 

I  .0 

maxval: 

2 

IS SUE:C 11 -  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

ISSUE :C 12 -  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

IS  SU£:C 13-  MINIMUM: 

.  72 

minval: 

4 

maximum: 

1.0 

MAXVAL: 

2 

IS  SUE :C  14  -  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

IS SUE:C 15-  MINIMUM: 

.72 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

IS  SUE :C lo -  MINIMUM: 

•  7C 

minval: 

4 

maximum: 

1.0 

MAXVAL: 

2 

ISSUE:C 18  -  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

IS SUE=C 19-  minimum: 

.70 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

IS  SU£:C20-  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.0 

MAX  val: 

2 

IS  SUE:C 21 -  minimum: 

.90 

minval: 

4 

maximum: 

1.0 

maxval: 

2 

IS  SUZ-C22 -  MINIMUM: 

.70 

MI NVAL= 

4 

maximum: 

1.0 

maxval: 

2 

ISSUE=C23-  MINIMUM: 

.  9C 

minval: 

4 

MAXIMUM: 

1.0 

maxval: 

2 

ISSUE :C24 -  MINIMUM: 

.70 

MINVAL: 

4 

MAXIMUM: 

1.0 

maxval: 

2 

ISSUE:C2S-  MINIMUM: 

.  70 

MINVAL: 

4 

MAXIMUM: 

1.0 

maxval: 

2 

I S SUE :C 27 -  MINIMUM: 

.  72 

MINVAL: 

4 

MAXIMUM: 

1.0 

maxval: 

2 

IS  SUE :£C1 -  MINIMUM: 

.98 

MINVAL: 

5 

M  A  X  I M  UM  : 

1.0 

maxval: 

2 

I S SUE :£ 02-  MINIMUM: 

.9* 

MINVAL: 

S 

MAX  I MUM: 

1  .0 

maxval: 

2 

ISSUE:E03-  MINIMUM: 

.  98 

MINVAL: 

s 

MAXIMUM: 

1.0 

maxval: 

2 

ISSUE :E  ON  -  MINIMUM: 

.98 

MINVAL: 

5 

maximum: 

1.0 

MAXVAL= 

2 

IS  SUE:E35-  MINIMUM: 

.98 

MINVAL: 

5 

MAXIMUM: 

l.C 

maxval: 

2 

IS  SUE=£  99  -  MINIMUM: 

.98 

MINVAL: 

5 

MAXIMUM: 

l.C 

maxval: 

2 

ISSUE  =E99P  MINIMUM: 

.98 

minval: 

5 

MAXIMUM: 

1.0 

maxval: 

2 

IS  SUE :E99  C  MINIMUM: 

.98 

MINVAL: 

5 

maximum: 

1.0 

MAXVAL: 

2 

IS SUE:F 01  -  minimum: 

.  7M 

MINVAL= 

4 

maximum: 

2.0 

maxval: 

2 

ISSUE :F 01 4  minimum: 

.  70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

IS  SUE :F  02  -  minimum: 

.70 

MINVAL: 

4 

maximum: 

2.0 

MAXVAL: 

2 

IS  SU£:F  C2  *  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

2.3 

maxval: 

2 

I S SUE :F  03 -  MINIMUM: 

.70 

minval: 

4 

MAXIMUM: 

2.0 

maxval: 

2 

I S SUE :F 04 -  MINIMUM: 

.70 

minval: 

4 

maximum: 

2.0 

maxval: 

2 

I S SUE :F 04  A  MINIMUM: 

.  70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

ISSUE=FQ46  minimum: 

.70 

minval: 

4 

maximum: 

2.0 

maxval: 

2 

I S SUE  :F  05 -  minimum: 

.70 

minval: 

4 

maximum: 

2.0 

maxval: 

2 

IS  SUE:F05  5  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

ISSUE :F 059  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

IS SUE:F 06-  MINIMUM: 

.  70 

minval: 

4 

maximum: 

2.0 

MAXVAL: 

2 

I S SUE :F 06 4  MINIMUM: 

.70 

minval: 

4 

maximum: 

2.0 

MAXVAL: 

2 

IS SUE:F  07  -  MINIMUM: 

.70 

"INVAL: 

4 

maximum: 

2.0 

MAXVAL: 

2 

ISSUE-F37  A  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

I S SUE-F 08 -  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

IS  SUE -F  08  *  minimum: 

.70 

MINVAL: 

4 

maximum: 

2.3 

MAXVAL: 

2 

IS  SUE :F  09  -  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

ISSU£:F09A  minimum: 

.70 

MINVAL: 

4 

maximum: 

2.0 

maxval: 

2 

IS  SUE :F 39P  MINIMUM: 

.70 

MINVAL: 

4 

max  IMUM: 

2.0 

maxval: 

2 

I S  SUE :F  99  -  MINIMUM: 

.  70 

“INVAL: 

4 

maximum: 

2.3 

maxval: 

2 

IS  SUE :F 99  A  MINIMUM: 

.70 

minval: 

4 

maximum: 

2.0 

maxval: 

2 

ISSUE : J" 1 -  MINIMUM: 

.98 

minval: 

5 

maximum: 

1.0 

maxval: 

2 

I S SUE :K G1 -  minimum: 

.98 

minval: 

5 

maximum: 

1.0 

maxval: 

2 

IS  SUE 99  -  MINIMUM: 

.98 

MINVAL: 

5 

maximum: 

1.0 

maxval: 

2 

ISSUE=001 -  MINIMUM: 

.98 

minval: 

5 

maximum: 

1 .0 

maxval: 

2 

IS  SUE :T  01 -  MINIMUM: 

.  70 

minval: 

4 

maximum: 

l.S 

maxval: 

2 

IS  SUE :T  02  -  MINIMUM: 

.  70 

minval: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE=T03-  MINIMUM: 

.  70 

minval: 

4 

maximum: 

1.5 

maxval: 

2 

IS  SUE  =  T  ON  -  MINIMUM: 

.  7  n 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

I S SUE :T 35 -  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE :T  Ob  -  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

1 .5 

maxval: 

2 

IS  SUE :T07 -  MINIMUM: 

.  70 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE:TQo-  MINIMUM: 

.  70 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE :T  09  -  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE-T  10-  MINIMUM: 

.70 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE=T11-  minimum: 

.70 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

L. 

IS  SUE :T 12  -  MINIMUM: 

.72 

minval: 

4 

maximum: 

1.5 

maxval: 

2 

ISSUE  =T  13-  MINIMUM: 

.70 

minval: 

4 

maximum: 

1.5 

maxval: 

2 

IS  SUE : T  14  -  minimum: 

.  70 

«INVAL  : 

4 

maximum: 

1  .5 

maxval: 

2 

ISSUE :T99-  MINIMUM: 

.72 

MINVAL: 

4 

maximum: 

1.5 

maxval: 

2 

I S SUE:wO 1 -  MINIMUM: 

.  98 

MINVAL : 

s 

maximum: 

1.3 

maxval: 

•> 

ISSUE  =w9S -  minimum: 

.98 

MINVAL: 

5 

maximum: 

1.3 

maxval: 

2 

Figure  C-6.  Value  File  Example 
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MAXI MUM=X .XXX 


Maximum  percentage  fill  converted  to  decimal.  For 
each  record  created  above,  if  MAXIMUM  is  greater  than 
MINIMUM,  another  record  is  created  with  a  minimum  fill 
of  zero  for  all  grade  levels  and  for  the  minimum 
aggreate  fill.  The  desired  maximum  fill  level  is  the 
desired  (i.e.,  authorized  or  required)  fill  times 
MAXIMUM.  Since  the  minimum  fill  should  be  assigned  in 
response  to  the  first  record,  the  number  entered  as 
the  maximum  in  this  record  is  the  minimum  fill  level 
subtracted  from  the  desired  maximum  fill  level. 

"MAXVAL=XXX  The  value  for  each  assignment  above  the  minimum  fill 

level,  up  to  the  maximum  fill  level.  This  value  is 
normally  smaller  than  the  values  used  in  the  Policy 
file  and  the  MINVAL  in  this  file. 


C.5  REPORT  REQUEST  FILE 

a.  Purpose.  The  Report  Request  file  specifies  the  formatted  readiness 
reports  to  be  produced  by  the  Report  Processor.  The  different  readiness 
report  types  are  specified  in  Table  C-3;  the  column  numbers  can  be  found  in 
the  description  Job  file  93. 


Table  C-3.  Readiness  Report  Types 


Report  Report  Report  name 

type  subtype 


1 

2 

3 


4 

5 

6 
7 
3 

9 

10 


11 


ISSUE  Summary  Report 
Specialty  Summary  by  Aggregate  ISSUE 
ALL  Specialty  Summary  by  ISSUE  -  All  Specialties 

MOS  code  Specialty  Summary  by  ISSUE  -  Specified 

Special ty 

Specialty  Summary  by  Grade 
Grade  Summary  by  Aggregate  ISSUE 
Grade  Summary  by  ISSUE 
High  Five  Summary 

ALL  ISSUE  Listing  -  ALL  ISSUES 

ISSUE  code  ISSUE  Listing  -  Specific  ISSUE 

C-rating 

ALL  Excess  Personnel  -  ALL  Types 

ORIGINAL  Excess  Personnel  from  Regular  Assignment 

MOS  SUB  Excess  Personnel  from  MOS  Substitution 

GRADE  SUB  Excess  Personnel  from  Grade  Substitution 

ALL  Unfilled  Jobs  -  All  Types 

ORIGINAL  Unfilled  Jobs  from  Regular  Assignment 

MOS  SUB  Unfilled  Job  from  MOS  Substitution 

GRADE  SUB  Unfilled  Jobs  from  Grade  Substitution 
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b.  Conditions  and  Requirements.  All  formatted  readiness  report  types 
within  the  range  of  01  to  11. 

c.  Data  Entries.  This  file  is  not  variable  except  for  the  YES/NO  and 
WHICH  fields.  All  report  entries  should  remain  in  the  file,  change  only 
the  YES/NO  field  and  MOS  or  ISSUE  in  the  WHICH  field. 


Description 


A  valid  two  character  readiness  report  number 

Either  "YES"  or  "NO."  When  this  report  type  is  to 
be  produced,  set  YES/NO  to  "YES."  When  this 
report  type  is  not  to  be  produced,  set  YES/NO  to 
"NO." 

Report  type  must  be  "MOS,"  "ALL,"  "ORIGINAL,"  "MOS 
SUB,"  "GRADE  SUB,"  MOS  code,  or  ISSUE  code  when 
report  number  is  03,  08,  10,  or  11;  must  be  blank 
when  report  number  01,  02,  04,  05,  06,  07,  or  09. 

Report  name 


i  *• 


i 


►  ,  • 
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•Field 

REPNUM=XX 

YES/NO 

WHICH 


REPNAM 
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APPENDIX  D 

PERSONNEL  SCHEDULING  PROGRAM 


USER  MANUAL’ 


The  operations  of  the  personnel  scheduling  program  are  reviewed  in 
this  report  from  the  standpoint  of  a  user  of  the  system. 

Schematically,  an  overall  flowchart  of  the  system  is  shown  in  Figure  1. 
There  are  three  independent  subroutines:  FORM,  in  which  the  network  and  the 
informational  data  base  are  established;  SOLVE,  in  which  the  network  is  optimized; 
and  REPORT,  in  which  the  report  writing  functions  are  contained.  Broad  input 
categories  and  their  respective  position  in  the  program  logic  are  also  depicted 
in  Figure  1. 

The  underlying  network  model  is  portrayed  in  Figure  2  and  contains  two 
general  categories  of  data,  people-related  and  job-related.  In  this  model, 
people  are  designated  as  resources  which  are  allocated  to  jobs  and  other  work- 
related  tasks.  Flow  in  the  network  is  specified  by  full  time  equivalents 
(1  man  year) . 

The  FORM  routine  accepts  people  and  job  data,  and  generates  the  network 
arrays  as  well  as  a  series  of  linked-list  pointer  arrays.  These  linked-lists 
are  used  in  identifying  and  categorizing  subsets  of  people  and  jobs.  For 
example,  a  reasonable  subset  descriptor  might  be  job  rank,  since  the  user  might 
be  interested  in  viewing  the  officers'  schedules.  This  is  accomplished  by 
providing  one  linked-list  for  all  personnel  at  the  officer  position. 


♦Source:  Mulvey,  John  M.,  Personnel  Models  With  Multiple  Objectives, 
Research  Report  EES-84-3,  Princeton  University,  January,  1984.  Submitted  as 
a  final  report  for  Scientific  Services  Agreement,  DAAG29-81-D-0100 ,  Delivery 
Order  Number  0789(TCN  83-403). 
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Figure  2 
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The  scruccure  of  the  linked-lists  is  shown  in  Figure  3.  For  each 
descriptor  subset  (subgrouping) ,  there  is  an  array  which  points  to  the  first 
element  in  the  list.  This  array  is  called  IRES  for  the  resource  subsets,  and 
IDEM  for  the  demand  subset.  The  main  link-list  vector  is  called  MFTHRD.  To 
save  high-speed  memory,  the  actual  resources  and  demand  names  are  not  stored 
in  the  full  linked-list  but  reside  in  a  separate  array  (NAMES) .  This  scheme 
saves  high-speed  memory  but  requires  an  extra  computer  reference.  The  maximum 
length  of  the  main  link-list  array  is  fifteen  hundred  entries.  Thus,  each 
personnel  and  demand  can  reside  in  three  subsets  on  the  average  because  there 
are  a  maximum  of  500  entries  in  the  NAMES  array.  Obviously,  the  average  number 
of  subsets  can  be  increased  if  there  are  less  than  five  hundred  resources/  demands. 
For  further  details  of  linked-list  structures,  see  Rlingman  and  Mulvey  [5]. 

The  SOLVE  routine  identifies  the  optimal  assignment  of  resources  to 
jobs  based  on  the  preference  data  (cost  coefficients)  and  resource /demand 
restrictions  (lower  and  upper  bounds  on  flow).  At  present,  there  are  no  user 
inputs  for  SOLVE,  and  the  only  printed  output  is  the  value  of  the  objective 
function  at  the  optimal  solution  or  an  infeasibility  message,  whichever  is 
appropriate. 

SOLVE  employs  a  modification  of  the  primal-dual  network  algorithm 
SUPERK  that  is  described  in  Barr,  Glover,  and  Klingman  fn.  This  algorithm 
can  easily  restart  from  any  point  (feasible  or  infeasible)  provided  a  circulation 
condition  is  observed.  The  subroutine  requires  nine  arc-length  and  four  node¬ 
length  arrays  during  execution.  Unfortunately,  all  of  these  arrays  must  remain 
in  high  speed  memory;  hence,  an  efficient  external  v_. t _  r,  of  the  system  seems 
unlikely.  In  the  current  implementation,  the  program  has  a  limitation  of  1000 
nodes  and  3500  arcs  resulting  in  146K  byte-length  arrays  and  a  244K  byte-length 
total  code  which  is  quite  manageable  on  most  mainframe  computers. 
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The  third  major  subroutine.  REPORT,  takes  the  optimal  network  and 
the  Informational  data  base  and  develops  the  personnel  schedule  for  output 
printing  according  to  user  input  settings.  Multiple  printing  options  are 
available  (see  section  2).  Furthermore,  REPORT  Is  designed  as  a  multi-pass 
routine. 

Several  basic  files  make  up  the  personnel  scheduling  system.  The  major 
components  of  the  input  data  file  are  displayed  in  Figure  4.  The  initial  elements 
consist  of  the  namelist  parameters.  This  data  is  followed  by  demand-related 
and  then  resource-related  information.  The  report  writing  data  occupies  the 
last  elements  In  the  input  data  deck. 

We  have  subdivided  the  remaining  description  of  this  users  manual  into 
3  subsections.  In  the  first  subsection,  the  inputs  to  FORM  are  examined  in  the 
context  of  an  example  problem.  Next,  the  inputs  to  REPORT  are  detailed.  Including 
the  subset  printing  feature.  Here  the  four  principal  types  of  printing  functions 
are  described  in  terms  of  an  example.  Lastly,  the  error  detection  and  warning 
devices  are  prescribed.  We  also  provide  a  brief  discussion  of  important  input 
data  and  its  effect  on  the  final  schedule. 

1.  Inputs  to  the  FORM  Subroutine 

The  procedure  for  describing  user  Inputs  is  the  following.  First, 


a  listing  of  the  data  is  provided  which  includes  a  description  of  type  of  data 
and  the  various  options.  An  example  is  shown  in  which  the  exact  input  formats 
are  described.  Finally  the  delimiters,  if  any,  are  listed. 


1.1  SNAMl  -  NAMELIST 


The  first  data  category  is  the  namelist  KAMI,  which  is  used  to  alter 
basic  network  data  —  in  particular  the  names  (titles)  of  the  linked  list 
|  arrays  which  identify  the  subsets  —  and  to  engage  the  debug  options  (flags). 

It  should  be  mentioned  that  namelist  is  a  free  format  method  for  inputing  data 
and  variables  are  separated  by  blanks  or  commas.  The  following  parameters  are 
provided  in  this  namelist: 

f  IRES  :  identifies  resource  subsets 

default  values: 

DATA  ISIS  /3u.\LL,  bECiit’Tr:,  SuliOU?., 

X  5HOTHEE  ,2S*4H  / 


OTJMRS:  number  of  consecutive  non-blank  entries  in  IRES  vector 
default  value:  23 

IDEM:  identifies  demand  subsets 
default  values : 


DATA  IDES 
X5  HOT  HER  ,3  HtUF 


1  o  A 


/3  ii.\  LL,  5KC.H ?!  I  ,5  !i  r.  JTO  1 .  b  .  Hi 
3hj?m,  2:-r:#3KiKt,  2. 


I#  7  ’.i 
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NUMDM:  number  of  non-blank  entries  in  IDEM  vector 
default  value:  23 

IACT(20):  identifies  aopropriate  names  for  subsets  of  the  resources 
and  demands  (called  activities) 
default  values: 


DATA  IACT  /3:icN'l,  3iiL:i2,3:i£N3,7*Uti  / 

NOMACT:  number  of  activities 
default  values:  8 

FL:  logical  debug  flags  (except  for  FL(15)  which  is  a  printing 
option) 

default  values: 

DATA  FI  /15*.FA13J./ 

The  sole  restriction  regarding  the  construction  of  subset  descriptions  is  that 
the  universal  subset  must  be  the  first  entry  in  the  IRES  and  IDEM  arrays. 

It  should  also  be  mentioned  that  if  the  fifteenth  element  of  the  FL 
vector  is  set  to  true,  the  program  skips  the  scheduling  mechanism,  SOLVE,  and 
output  consisted  exclusively  of  data  from  the  updating  capabilities.  A  sample 
namelist  is  shown  here 


delimiter 


6NA31 


idf  i  (12)*  y-.o  t*:  3  r 


column  2 


D-9 


Job  names  should  appear  In  alphabetical  order  or  in  some  other  suitable  scheme 
since  output  will  occur  In  the  sequence  that  they  are  Input.  Also,  since  names 
are  unique  identifiers,  they  cannot  be  duplicated  within  one  run.  The  lower 
and  upper  bound  restrictions  (min,  max)  are  checked  for  consistency  as  described 
In  Section  3. 

An  example  of  job-related  data  with  12  real  jobs  and  9  super  jobs  is 
listed  In  Figure  5  .  Consisting  of  three  parts,  the  Input  specifications  for 
the  real  jobs  are  shown  in  Figure  6  .  The  first  part  (card  #1)  defines  the  name 
of  the  job  —  ECHOS  —  and  the  number  of  subsets  that  belong  to  this  job — 2.  The 
next  part  (card  #2)  lists  the  names  of  the  subsets  —  EUR,  and  CMPTR.  The  third 
part  (cards  #3  and  4)  provide  information  regarding  the  arc  bounds:  card  #3 
indicates  the  lower  and  upper  bounds  for  the  total  flow, — 12,12 — .whereas  card 
indicates  lower  and  upper  bounds  for  flow  on  each  activity  arc — 3, 3, 4, 4, 5, 5. 
Additional  cards  may  be  needed  when  the  number  of  activities  is  increased. 

A  critical  input  category  is  the  super  job.  These  are  distinguished 
by  the  name  SINK  in  the  first  column  and  have  the  characteristic  that  all  people 
within  the  appropriate  subset  are  able  to  be  assigned  to  this  job.  Figure  7 
provides  an  example  of  the  Input  specifications.  Again,  three  parts  are  defined. 

The  first  part  (card  #1)  indicates  (1)  that  the  job  is  a  super  job  (SINK), 

(2)  that  there  are  x  subsets  — 3  —  to  follow  on  the  next  card,  and  (3)  the 
name  of  the  super  job  —  CSEN1S.  The  second  part  (card  >7 2)  simply  lists  the  subsets 
for  this  particular  job — CMPTR,  EN1, OTHER.  Card  3  defines  the  resource  subset  that 
will  connect  to  this  super  job~CMPTR — ,  upper  bound  for  all  arcs  pointing  into 
this  node  —  45  — ,  preference  cost  for  inward  oointine  arcs  — $-6  — ,  relevant 
activity  —  EN1  — ,  preference  cost  for  outward  pointing  arc  —  0  — ,  and  upper 
be ind  for  outward  pointing  arc  —  45.  It  is  assumed  that  all  lower  bounds  for 
these  arcs  are  equal  to  zero. 

The  final  delimiter  for  the  demand-related  data  is  the  job  name  "END  DEM". 
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Figure  6 


1.3  Resource  Related  Inputs 

The  following  parameters  are  relevant  for  resource-related  inputs: 

1.  Complete  list  of  all  resource  categories  to  be  assigned 

2.  For  each  category 

a.  A  list  of  the  Jobs  that  are  eligible  to  be  assigned 

1.  From  historical  records 

2.  From  other  inputs,  including  requests  from  the 
relevant  administrations 

b.  Preferences  for  assignment  for  each  job  on  some  numerical 
scale  (e.g.,  -2  to  +2) 

c.  Number  of  people  of  each  job  chat  the  resource  category 
is  willing  to  be*  assigned. 

d.  Supply  limitations 

1.  total  (min,  max) 

2.  per  activity  (min,  max) 

e.  Relevant  subset  groupings  (e.g.,  European  command, 
computer  specialists) 

Similar  restrictions  apply  to  the  resource  subset  descriptions  and  to  the  demand 
subgroups.  That  is,  any  subset  can  be  used,  provided  that  the  name  is  preset  in 
IRES  and  the  universal  subset  is  the  first  entry  in  IRES. 

The  resource  data  is  input  in  a  manner  similar  to  the  demand-related 
data,  with  the  addition  of  a  menu  of  jobs  and  related  preferences.  An  example 
of  6  resource  categories  and  3  super  categories  is  detailed  in  Figure  8  . 
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The  Input  data  is  subdivided  into  4  parts  for  each  resource  category. 

In  part  1  (card  #1),  the  name  of  the  category  is  specified  —  COMSCI*,  followed 
by  the  number  of  subsets  —  1,  and  followed  by  the  number  of  relevant  jobs  —  5. 
Part  2  (card  #2)  contains  the  names  of  the  subsets  —  CMPTR.  Part  3  (cards  #3 
and  #4)  indicates  the  supply  limitations  for  the  total  category  (card  It 3  —  9,9), 
and  the  supply  limitations  for  each  activity  (card  H) ,  —  6, 6, 3, 3.  Finally, 
part  4  lists  the  relevant  jobs  with  the  accompanying  preference  cost  and  upper 
bound  (for  each  activity).  For  example,  the  third  job  for  "COMSCI"  is  "JPNCS" 
with  cost  *  $-1,  bound  »  2. 

It  should  be  stressed  that  the  relevant  jobs  can  be  defined  with  regard 
to  subsets.  Therefore,  the  definition  of  a  super-person  is  simply  a  matter  of 
specifying  the  appropriate  subset.  The  input  format  is  identical  to  that  of 
the  real  resource  categories. 

The  final  delimiter  for  the  resource-related  data  is  the  title  "END 
RES"  in  columns  1-7. 


2.  Report  Writing  Features 

The  final  component  REPORT  provides  the  following  four  basic  types  of 

output : 

1.  a  listing  by  resource  category  showing  the  total  assignments 
schedules  by  activity,  (ITYPE-1000) 

2.  a  listing  by  -iemand  category  showing  the  people  assigned  to 
it  by  activity  (ITYPE=0100) 


*  First  resource  category  in  Figure  8 


m 
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3.  for  each  activity,  a  listing  by  resource  category  showing  the 
assignments,  and  (ITYPE«0010) 

4.  for  each  activity  a  listing  by  job  showing  the  resource  categories 
assigned  to  it.  (ITY?E»0001> 


Any  or  all  of  these  four  types 

of  outputs  can 

be  obtained 

for  any  specified 

subset  of  the  resources  and  of 

the  demands  — 

provided  the 

subset  has  been 

previously  defined  in 

the  FORM  routine.  The 

report  writer 

continues  printing 

as  long  as  data  exist 

in  the  input  file.  Each  pass  contains  the  following 

elements: 

$NAM2 

IRES  -  ? 

IDEM  *  ? 

FL  -  ? 

NUMDM  -  ? 

NUMRS  -  ? 

JRUN  -  ? 

IACT  -  ? 

ITITLE  -  ? 

ITYPE  -  ? 

COLUMN 

2 

NUMACT  -  ? 

MLINES  -  ? 

TITTLE  -  ? 

SEND 

RESOURCE 

VAR1 

VAR2 

VAR3 

DEMANDS 

VAR4 

VAR5 

VAR6 

ACTIVITY 

VAR7 

VARS 

VAR9 

COLUMN 

1 

10 

20 

30 

I 


The  12  parameters  in  the  NAM2  namelist  define  various  control  settings 
l 

for  the  report  writer:  ITYPE  defines  the  type  of  run  and  its  characteristics 
are  shown  above  (any  combination  of  runs  is  oossible  by  adding  ITYPE  values, 
for  example,  a  type  1  and  type  2  run  is  output  by  setting  ITTPE-1100) ;  MLINES 
I  defines  the  number  of  lines  per  pages,  depending  upon  the  printer;  and  ITITLE 

defines  the  title  for  each  page  in  the  output. 
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The  default  values:  for  these  namelist  parameters  are  shown  below: 


DATA  HU3RS  /23/ ,SU  1D;1/23/.  NUS ACT/  8/,J?rJN/V 
C 

DATA  IDL^fC  /Oil  / ,  1L  I .'Ii.5/60/ 

C 

DATA  ITYPt/1111/ 

C 

C 

DATA  ITITLH  /  •  Pi'RSO  N N £•  ,  •  L  *  ,  *  SCIIET 1U  •  ,  *  FQ7 

:<•  1983-84  •  ,3*1H  / 


DATA  JTITL£ 

/  '  ACT  1 

1  « 

9 

ACT2 

Ac; 

3 

• 

/ 

X*  ACT4 

ACTS 

1  • 

9 

ACT  6 

ACT7 

•  f 
> 

AC  73  *, 

1 

ACT  <  •  , 

X*  ACT1 3 

ACT  11 

%  % 
i 

A  CT 1  2 

1  f 

9 

ACT  1  3 

•  I 

9 

AC  .  1  - 

9 

a  :*  i  >  ' , 

X*  ACT  16  *, 

X*  ACT1 

ACT  2 

t  l 

t 

ACT  3 

ACT  4 

1  I 

9 

ACTS  *, 

• 

ACT- 

X*  ACT7 

ACT3 

•  i 

9 

ACT  9 

1  1 
$ 

ACTIO 

»  1 

9 

AC 71  1  ’  , 

P 

ACT  1C  '  . 

X*  ACT13 

ACT  14 

A  CT  1  5 

•  * 

/ 

ACT  1b 

•,1b* 

'•  JC3S 

9 

After  this  namelist  has  been  input,  the  resource  categories  to  be 


output  are  identified  on  a  special  card  called  a  RESOURCE  card.  Several 
possibilities  exist:  any  individual  resource  category  can  be  listed  as  well 
as  any  subset  of  the  resources  (as  identified  by  the  linked  lists)  and  any 
combination  thereof.  Following  this  data,  the  jobs  are  specified  on  a  similar 
card  which  is  called  a  DEMANDS  card.  Finally,  the  activities  can  also  be 
identified  on  an  ACTIVITY  card.  A  777  card  is  a  delimiter  for  this  data  group. 

The  following  example  demonstrates  some  of  the  input  characteristics 
of  the  input  writer: 


SNAM2 

rr.FE-1111 

.MLINES-60 

RESOURCE 

ALL 

DEMANDS 

ALL 

ACTIVITY 

EN1 

EN2 

777 

t 

t 

COLUMNS  -0 


10 


20 


SEND 


EN3 


and  the  respective  sample  output  for  the  example  appear  in  Figures  9  through  1 
corresponding  to  type  1,  2,  3,  and  4  output  (since  ITYPE»1111). 
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3.  Error  Detection  Analysis 

Various  conditions  of  the  inputs  are  checked  for  consistency  and  errors 
are  identified.  Warning  messages  indicate  non-fatal  conditions;  however,  these 
should  be  checked  by  the  user.  Several  types  of  inconsistencies  are  fatal. 

For  example,  a  minimum  flow  of  5  and  a  maximum  flow  of  4  on  the  same  arc  cannot 
be  processed  by  SOLVE  and  is  deemed  as  a  fatal  error. 

Any  time  that  an  infeasible  network  occurs,  the  final  printed  results 
will  always  be  in  error  since  the  SOLVE  subroutine  immediately  terminates  upon 
detection  of  an  infeasible  arc.  In  this  situation,  the  user  is  encouraged  to 
search  the  output  for  inconsistency  messages  or  other  error  or  warning  consents. 
If  this  search  does  not  indicate  the  source  of  the  error,  the  network  is  probably 
infeasible  because  the  super  people  and/or  the  super  jobs  do  not  have  enough 
capacity  or  do  not  link  with  the  appropriate  resource  categories.  The  easiest 
method  to  remedy  this  situation  is  using  a  single  super  person  (ALL)  and  a  single 
super  job  (ALL)  with  a  very  large  capacity,  although  this  scheme  is  inefficient 
and  may  cause  boundary  overflows. 

Another  potential  problem  involves  the  array  dimensions.  The  following 
limits  cannot  be  exceeded: 

NAMES:  500  people  +  jobs 

number  of  resource  subsets:  30 


number  of  job  subsets:  30 

number  of  periods:  16 

number  of  nodes  in  the 

network:  1000 

number  of  arcs  in  the 

network:  3500 


unless  a  programming  change  is  made  to  the  FORTRAN  source  file. 
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Several  debug  flags  are  provided  co  assist  a  knowledgeable  user  in 
tracing  difficulties,  but  these  should  be  used  only  as  a  last  resort: 


FLAG 

FLU) 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


APPLICABLE  PORTION  OF  THE  CODE  &  COMMENTS 

FORM  -  duplicates  network  inputs 
not  used 

more  details  in  FORM  (network  arcs) 
arrays  for  SOLVE  (all  input  network  arrays) 

results  from  SOLVE  (final  flow  array) 

report  writing  inputs  (duplicates  reporting  writing  inputs) 

detailed  report  writing  arrays 

lists  arrays  for  SOLVE 

not  used 

not  used 

not  used 

not  used 

see  section  1 


We  next  turn  to  a  brief  discussion  of  procedural  concerns.  The  worth 
of  the  final  schedule  depends  upon  a  variety  of  factors.  One  of  the  most  important 
is  the  menu  of  job  for  each  personnel  category.  This  listing  must  represent  all 
of  those  jobs  which  the  scheduler  is  willing  to  place  the  resource  category  in, 
since  preference  cannot  override  an  arc  that  does  not  occur.  By  this  we  mean 
that  a  resource  category  will  never  be  assigned  to  any  job  which  are  not  in 
his  list.  Hence  the  importance  of  a  proper  menu.  Therefore,  the  scheduler 
should  carefully  review  the  list  of  relevant  jobs  for  each  resource  category. 

Priority  schemes  can  easily  be  incorporated  into  this  system  by  biasing 
the  preference  weights  for  certain  individuals,  such  as  officers  (although  this 
procedure  is  not  directly  used  in  most  environments).  Likewise,  important  jobs 
which  are  not  being  assigned  can  also  be  biased  through  the  weights.  For 
instance,  the  European  assignments  can  be  allowed  a  preference  weight  of  -99 
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to  +99,  while  the  other  jobs  are  allowed  a  preference  range  of  -10  to  +10. 

In  this  situation,  the  European  assignments  overrides  the  other  preferences 
since  the  objective  function  is  maximizing  the  sum  of  the  preferences.  In 
effect,  the  European  jobs  are  scheduled  ahead  of  all  other  jobs  with  this 
scheme.  See  references  (2,3,6,7,81  for  descriptions  of  multiple  objective 
methods . 

4.  Advanced  Feature 

In  addition  to  the  aforementioned  printed  outputs ,  the  report  writer 
generates  a  compact  version  of  the  final  assignments.  This  file  is  saved  on 
disk  (or  tape)  unit  #2.  Four  vectors  are  included: 

IDIFFl(-):  resource  (personnel  category) 

IDIFF2(*):  demand  (job  category) 

IDIFF3 ( ■ ) :  activity 
IDIFF4 ( •) !  arc  flow 

Each  element  in  these  arrays  corresponds  to  a  particular  assignment  arc  in  the 
network.  Thus,  the  j^  position  will  provide  a  (resource-demand-activity-flow) 
combination.  To  save  storage,  we  employ  pointers  to  the  NAMES  array  for  the  first 
three  of  these  vectors,  i.e.,  IDIFF1,  IDIFF2,  and  IDIFF3.  The  fourth  vector  — 
IDIFF4  —  consists  of  numbers,  indicating  arc  flow. 


m 
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ERRORS,  WARNINGS,  AND  OTHER  MESSAGES 
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ERROR  I  THE  ISSUE  FILE  IS  EMPTY. 

Conditions:  No  valid  ISSUE  definitions  were  found  in  the  ISSUE  file. 

Result:  File  must  be  corrected  and  the  Set  ISSUE  program  must  be  rerun. 

ERROR  2  ROLMOS/PROCESS  1.1.2  SHOULD  BE  REPROGRAMED.  THE  STRENGTHS  AT  THE 
3-DIGIT  UIC  LEVEL  ARE  LARGER  THAN  ALLOWED  FOR  BY  THE  FORMAT. 

Conditions:  The  number  of  jobs  is  larger  than  can  be  written  with  the 
format  16. 

Result:  The  computer  system  will  set  the  number  of  jobs  to  asterisks 
(*)  when  the  number  is  greater  than  999,999. 

ERROR  3  THE  MINIMUM  PERCENTAGE  IN  THE  VALUE  FILE  MULTIPLIED  BY  THE  NUMBER 
OF  JOBS  CREATED  A  RECORD  OF  ALL  ZEROES. 

Condition:  When  the  number  of  jobs  to  be  filled  is  very  small,  the 
result  of  the  multiplication  may  round  down  to  zero.  For  example,  if  there 
is  only  one  job  to  be  filled,  a  percentage  of  less  than  50  percent  will 
round  down  to  zero. 

Result:  The  job  record  is  written  to  the  Unfilled  Job  file  instead  of 
to  the  Job  Assignment  Value  file. 

ERROR  4  GRADE  IN  JOB  DATA  IS  NOT  IN  PARAMETER  FILE. 

Condition:  The  Parameter  file  did  not  specify  the  grade  code  found  in 
the  MOS  data  as  a  valid  grade. 

Result:  The  data  with  the  invalid  grade  is  not  written  to  the  output 
file. 

ERROR  5  ISSUE  DATA  NOT  COMPLETE.  ISSUE  NOT  FOUND  FOR  UIC. 

Condition:  If  the  message  is  from  process  1.2.3,  the  UIC  record 
specified  does  not  belong  to  a  valid  ISSUE,  i.e.,  the  ISSUE  definitions 
were  not  complete.  The  specified  unit  was  not  included  in  any  ISSUE 
definitions.  If  the  message  is  from  process  1.2.5,  there  was  an  MOS  record 
which  did  not  get  the  ISSUE  set;  the  UIC  record  may  have  been  missing  from 
the  input  file  (file  22) . 

Result:  The  unit  for  which  the  ISSUE  was  not  defined  will  have  the 
ISSUE  set  to  " - ",  the  "invalid"  designation. 


E-l 


CAA-D-84-2 


ERROR  6  PROGRAMING  MUST  BE  ADDED  TO  PROCESS  1.2  TO  SET  ISSUES  FOR  ID1  and 
ID2. 

Condition:  ISSUE  definitions  of  ID1  and  ID2  were  not  one  of  the  valid 
combinations  from  Table  B-l,  ISSUE  Identification  Methods. 

Result:  No  units  will  have  the  ISSUE  set  according  to  this  definition. 

ERROR  7  NO  UIC-DATA  RECORD  FOUND  FOR  ISSUE. 

Condition:  An  ISSUE  definition  did  not  match  any  data  in  the  UlC-data 
file. 

Result:  The  definition  is  otherwise  ignored. 

ERROR  9  ISSUE  ON  JOB  FILE  NOT  ON  CURRENT  ISSUE  FILE. 

Condition:  During  the  writing  of  the  formatted  readiness  reports,  the 
ISSUE  codes  found  on  the  readiness  files  (which  come  from  the  Job  file)  are 
matched  with  the  ISSUE  Definition  file  to  get  the  ISSUE  name.  If  an  ISSUE 
code  is  not  found,  this  message  is  written,  and  the  subroutine  ISSUNA 
provides  an  error  indication  to  the  report  writing  program. 

Result:  The  report  processor  stops  for  the  user  to  provide  the  correct 
ISSUE  Definition  file. 

ERROR  10  ISSUE  ON  POLICY  FILE  NOT  DEFINED  IN  ISSUE  FILE. 

Condition:  The  ISSUE  and  Policy  files  are  incompatible.  All  ISSUES  on 
the  Policy  file  must  be  defined  on  the  ISSUE  file. 

Result:  The  Policy  record  is  ignored. 

ERROR  11  LOW  GRADE  IN  POLICY  FILE  IS  BLANK. 

Condition:  The  low  grade  in  the  Policy  file  is  blank. 

Result:  The  Policy  record  is  ignored. 

ERROR  12  HIGH  GRADE  IN  POLICY  FILE  IS  BLANK. 

Condition:  The  high  grade  in  the  Policy  file  is  blank. 

Result:  The  Policy  record  is  ignored. 

ERROR  13  LOW  GRADE  IN  POLICY  FILE  IS  INVALID. 


Condition:  The  low  grade  in  the  Policy  file  must  be  El  through  E9,  WO, 
or  01  through  06  and  must  be  specified  in  the  Parameter  file. 


Result:  The  Policy  record  is  ignored. 


ERROR  14  HIGH  GRADE  IN  POLICY  FILE  IS  INVALID. 

Condition:  The  high  grade  in  the  Policy  file  must  be  El  through  E9,  WO, 
or  01  through  06  and  must  be  specified  in  the  Parameter  file. 

Result:  The  Policy  record  is  ignored. 

ERROR  15  HIGH  GRADE  IN  POLICY  FILE  IS  LESS  THAN  LOW  GRADE. 

Condition:  The  high  grade  in  the  Policy  file  must  be  the  same  as  or 
larger  than  the  low  grade  in  the  Policy  file. 

Result:  The  Policy  record  is  ignored. 

ERROR  16  MINIMUM  IN  POLICY  FILE  IS  GREATER  THAN  2.0.  MINIMUM  USUALLY  1.0. 

Condition:  The  minimum  percentage  is  greater  than  200  percent;  the 
usual  minimum  percentage  is  less  than  100  percent. 

Result:  The  Policy  record  is  applied  using  the  rate  that  was  input. 

ERROR  17  MAXIMUM  IN  POLICY  FILE  IS  GREATER  THAN  2.0. 

Condition:  The  maximum  percentage  in  the  Policy  file  is  greater  than 
200  percent;  the  usual  maximum  percentage  is  near  100  percent. 

Result:  The  Policy  record  is  applied  using  the  rate  that  was  input. 

ERROR  18  MINIMUM  IN  POLICY  FILE  GREATER  THAN  MAXIMUM  ON  POLICY  FILE. 

Condition:  The  minimum  in  the  Policy  file  is  greater  than  the  maximum. 

Result:  The  Policy  record  is  ignored. 

ERROR  19  VALUE  IN  POLICY  FILE  LESS  THAN  ZERO. 

Condition:  A  negative  value  was  found  in  the  Policy  file. 

Result:  The  negative  value  is  applied  to  the  MOS  data. 

ERROR  20  CHECK  VALIDITY  OF  MINIMUM  AND  MAXIMUM  PERCENTAGES  ON  POLICY  FILE 
FOR  ISSUE. 

Condition:  The  minimum  percentage  and/or  the  maximum  percentage  on  the 
Policy  file  is  invalid  for  the  specified  ISSUE. 

Result:  The  Policy  record  is  ignored. 


ERROR  21  AGGREGATE  VALUE  SHOULD  NOT  BE  BLANK,  VALID  VALUES  ARE  YE  (FOR 
YES)  OR  NO. 

Condition:  AG=  on  the  Policy  file  must  be  followed  by  NO  for  a  non- 
aggregated  policy  or  by  YES  for  an  aggregated  policy. 

Result:  The  Policy  record  is  ignored. 

ERROR  22  INVALID  AGGREGATE.  THERE  IS  AN  INVALID  OVERLAP  OF  GRADES  USING 
MULTIPLE  AGGREGATES  FOR  ONE  ISSUE. 

Condition:  The  same  grade  may  not  be  included  in  more  than  one  specifi¬ 
cation  for  the  same  ISSUE,  MOS,  or  combined  ISSUE/MOS. 

Result:  All  but  the  first  specification  will  be  ignored.  Aggregate- 
ISSUE  level  specifications  are  considered  first.  A  later  specification  for 
the  same  grade(s)  for  a  specific  ISSUE  will  be  ignored. 

ERROR  23  UNABLE  TO  SET  MINIMUM  AND  MAXIMUM  FILL  LEVELS  FOR  ISSUE. 

Condition:  Either  the  minimum  percentage  or  the  maximum  percentage  in 
the  Value  file  is  invalid. 

Result:  Record  is  not  written  to  the  JAV  file.  Correct  the  Value  file 
and  rerun. 

ERROR  24  THE  JOB-ASSIGNMENT-VALUE  FILE  IS  EMPTY. 

Condition:  No  valid  entries  found  in  Value  file.  File  19. 

Result:  No  additional  records  were  written  to  the  Job  Assignment  Value 
file  (40). 

ERROR  25  INCORRECT  FORMAT  FOUND  IN  VALUE  FILE  FOR  ISSUE. 

Condition:  Data  in  Value  file  is  not  in  the  specified  format. 

Result:  No  additional  records  for  the  specified  ISSUE  were  written  to 
the  JAV  file. 

ERROR  26  UNABLE  TO  SET  ASSIGNMENT  VALUES  FOR  ISSUE. 

Condition:  When  written  from  Apply  Policy,  the  number  of  MOS  per  ISSUE 
was  greater  than  676;  when  written  from  Set  Base  Values,  there  was  not  a 
valid  Value  record  for  this  ISSUE. 

Result:  Record  is  not  written  to  the  JAV  file.  Check  output  from  Set 
ISSUE,  1.2.  If  more  than  676  MOS  are  in  one  ISSUE,  delete  or  correct 
errors  in  the  MOS  file.  Make  sure  ISSUE  codes  match  (all  four  characters) 
in  the  ISSUE  and  Value  file. 
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ERROR  27  POLICY  FILE  IS  EMPTY. 

Condition:  No  valid  entries  were  found  in  the  Policy  file. 

Result:  All  JAV  records  will  be  based  on  the  data  from  the  Value  file. 

ERROR  30  INVALID  GRADE  ON  PARAMETER  FILE. 

Condition:  The  grade  location  in  the  Parameter  file  was  not  a  2-digit 
integer  with  a  value  of  16  or  less. 

Result:  The  location  is  not  included  as  a  valid  location. 

ERROR  31  INVALID  LOW  GRADE  VALUE  ON  PARAMETER  FILE.  VALUE  SHOULD  BE 
INTEGER. 

Condition:  Low  grade  must  be  an  integer  value  greater  than  zero  and 
less  than  16. 

Result:  The  program  cannot  correctly  set  the  subscript  values  for 
storing  the  data  by  grades.  The  error  must  be  corrected. 

ERROR  32  INVALID  HIGH  GRADE  ON  PARAMETER  FILE.  VALUE  SHOULD  BE  INTEGER 
AND  EQUAL  TO  NGRAOE. 

Condition:  High  grade  must  be  an  integer  value  greater  than  zero  and 
less  than  or  equal  to  16. 

Result:  The  program  cannot  correctly  set  the  subscript  values  for 
storing  the  data  by  grades.  The  error  must  be  corrected. 

ERROR  34  GRADE  IN  POLICY  FILE  IS  NOT  IN  PARAMETER  FILE 

Condition:  One  of  the  grades  on  the  specified  policy  record  does  not 
match  the  valid  grade  codes  entered  in  the  Parameter  file.  A  policy  cannot 
be  applied  to  grades  that  do  not  exist  in  the  input  data,  and  the  data  will 
contain  only  grades  specified  in  the  Parameter  file. 

ERROR  35  INVALID  GRADE  OVERLAP.  ONE  OF  THE  INCLUDED  GRADES  HAS  BEEN  USED 
ON  A  PREVIOUS  POLICY  FOR  AGGREGATED  GRADES. 

Condition:  One  or  more  grades  has  been  used  in  more  than  one  policy 
that  is  of  the  type  that  is  aggregated  across  grades.  No  more  than  one 
policy  can  be  applied. 

Result:  The  entire  record  containing  the  policy  that  is  specified  in 
the  error  message  is  ignored. 
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ERROR  36  INVALID  GRADE  OVERLAP.  ONE  OF  THE  INCLUDED  GRADES  HAS  BEEN  USED 
ON  A  PREVIOUS  POLICY  FOR  NONAGGREGATED  GRADES. 

Condition:  One  or  more  grades  has  been  used  in  more  than  one  policy 
that  is  of  the  type  that  is  not  aggregated  across  grades.  No  more  than  one 
policy  can  be  applied. 

Result:  The  entire  record  containing  the  policy  that  is  specified  in 
the  error  message  is  ignored. 

ERROR  37  AS  OF  DATE  IS  HISSING  FROM  THE  PARAMETER  FILE. 

Condition:  As  stated,  there  is  no  as  of  date  in  the  Parameter  file  or 
the  variable  name  is  not  spelled  correctly  in  the  Parameter  file. 

Result:  The  report  program's  will  show  a  blank  as  of  date. 

ERROR  39  NGRADE  IS  HISSING  FROM  PARAMETER  FILE. 

Condition:  NGRADE  is  not  specified  correctly.  Either  it  was  not 
spelled  correctly,  not  placed  in  the  correct  columns,  or  the  integer  did 
not  convert  correctly  to  an  integer  of  16  or  less. 

Result:  The  program  will  not  correctly  process  any  further  data. 

ERROR  40  NCCHAR  IS  MISSING  FROM  PARAMETER  FILE. 

Condition:  Either  NCCHAR  is  not  in  the  Parameter  file,  it  is  misspelled 
in  the  Parameter  file,  or  it  is  not  in  the  right  columns  in  the  Parameter 
file. 

Result:  The  number  of  characters  cannot  be  compared  in  the  Assignment 
program.  All  programs  using  NCCHAR  must  be  rerun. 

ERROR  41  TYPSTR  IS  MISSING  FROM  PARAMETER  FILE  -  USER  MUST  SPECIFY  WHETHER 
STRENGTH  SHOULD  BE  AUT  OR  REQ. 

Condition:  TYPSTR  is  either  not  in  the  Parameter  file,  is  misspelled  in 
the  Parameter  file,  is  not  in  the  right  columns  in  the  Parameter  file,  or 
the  AUT  and/or  REQ  is  missing. 

Result:  The  Policy  programs  cannot  continue.  Correct  the  Parameter 
file  and  rerun. 

ERROR  42  NCCHWO  IS  MISSING  FROM  PARAMETER  FILE. 

Condition:  Either  NCCHWO  is  missing,  misspelled,  or  in  the  wrong 
columns  in  the  Parameter  file. 

Result:  ROLMOS  program  cannot  work  correctly.  Correct  the  Parameter 
file  and  rerun  the  ROLMOS  program. 
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ERROR  43  THERE  HERE  NO  ISSUES  DEFINED  BY  UIC  ON  THE  ISSUE  DEFINITION  FILE 
(warning  message). 

Condition:  There  was  an  ISSUE  definition  in  File  14  that  was  not  used 
by  any  of  the  data  in  the  files. 

Result:  The  ISSUE  definition  was  ignored.  If  it  should  have  been  used, 
look  at  the  ISSUE  in  File  14,  find  the  error,  correct,  and  rerun  the  Set 
ISSUE  program. 

ERROR  44  INVALID  MOS  SPECIFICATION  ON  POLICY  FILE.  NUMBER  OF  CHARACTERS 
SPECIFIED  IS  LARGER  THAN  NUMBER  OF  CHARACTERS  SPECIFIED  ON  PARAMETER  FILE 
(warning  message). 

Condition:  The  Policy  stated  in  the  Policy  file  contained  a  larger 
number  of  characters  in  the  MOS  than  had  been  specified  in  the  Parameter 
file. 

Result:  This  Policy  will  be  ignored  unless  the  Policy  file  is  corrected 
and  the  Apply  Policy  programs  rerun. 

ERROR  45  THE  SUM  OF  THE  MAXIMUM  FILL  OF  GRADES  IS  LESS  THAN  THE  MINIMUM 
AGGREGATE  FILL. 

Condition:  At  least  two  policy  records  were  taking  effect  at  the  same 
time.  One  would  have  been  for  the  aggregate  of  several  grades,  and  the 
other  would  have  been  for  the  grades  within  that  aggregate  having  a 
different  minimum  percentage  fill.  When  the  sum  of  the  maximum  fill  of  the 
individual  grades  is  less  than  the  minimum  required  fill  for  the  aggregate 
of  those  grades,  the  Assignment  programs  will  give  an  infeasible  arc.  This 
error  must  be  corrected  on  the  Policy  file  and  the  Policy  programs  rerun. 

Result:  The  record  is  ignored. 

ERROR  46  INVALID  GRADE  OVERLAP  ON  POLICY  FILE.  THERE  IS  MORE  THAN  ONE 
SPECIFICATION  FOR  GRADE. 

Condition:  More  than  one  policy  included  this  grade. 

Result:  The  second  policy  is  ignored. 

ERROR  61  THE  MAXIMUM  IS  LESS  THAN  THE  MINIMUM  ON  THE  VALUE  FILE. 

Condition:  The  maximum  percentage  fill  was  less  than  the  minimum  per¬ 
centage  fill  on  the  Value  file  (File  19).  This  will  be  impossible  to  fill 
to  more  than  the  minimum  stated.  One  record  for  the  minimum  percentage 
fill  will  be  written  to  the  dob  Assignment  Value  file. 

Result:  Only  the  minimum  is  used. 
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ERROR  62  MAXIMUM  VALUE  ON  VALUE  FILE  IS  LARGER  THAN  THE  MINIMUM  (warning 
message). 

Condition:  The  value  for  the  maximum  percentage  would  normally  be 
smaller  than  the  value  for  the  minimum  percentage.  When  it  is  not,  this 
error  is  given  as  a  warning. 

Result:  The  records  have  been  written  to  the  Job  Assignment  Value  file. 
If  this  was  not  desired,  the  Value  file  should  be  corrected  and  the  Set 
Base  Value  program  rerun. 

ERROR  70  THE  INPUT  MOS  FILE  IS  NOT  SORTED  CORRECTLY.  ISSUES  ARE  NOT  IN 
ORDER. 

Condition:  Each  ISSUE  code  is  checked  against  the  previous  ISSUE  code. 
The  last  code  must  always  be  greater  than  or  equal  to  the  previous  code. 

If  not,  the  MOS-data  file  aggregation  will  not  be  performed  correctly. 

Result:  The  program  will  halt  with  the  error  message.  The  user  must 
sort  the  MOS-data  file  on  MOS  within  ISSUE  code  and  rerun  process  1-3, 
Aggregate  MOS-data. 

ERROR  71  THE  INPUT  MOS  FILE  IS  NOT  SORTED  CORRECTLY.  MOS  NOT  IN  ORDER. 

Condition:  Each  MOS  is  checked  against  the  previous  MOS.  The  last  MOS 
must  always  be  greater  than  or  equal  to  the  previous  MOS.  If  not,  the  MOS- 
data  file  aggregation  will  not  be  performed  correctly. 

Result:  The  program  will  halt  with  the  error  message.  The  user  must 
sort  the  MOS-data  file  on  MOS  within  ISSUE  code  and  rerun  process  1-3, 
Aggregate  MOS-data. 

ERROR  96  MORE  THAN  300  ISSUES  ARE  DEFINED  ON  THE  ISSUE  FILE. 

Condition:  No  more  than  300  ISSUE  codes  may  be  defined.  The  Edit 
Policy  program  found  more  than  300  unique  ISSUE  codes. 

Result:  Policies  for  all  ISSUEs  numbered  301  and  up  will  be  ignored. 

ERROR  97  UNABLE  TO  WRITE  UNIQUE  DEMAND  NODE  NAME  IN  POLICY  PROCESSOR  FOR 
THE  PRESENT  DEMAND  NODE  IDENTIFIER. 

Condition:  More  than  676  different  MOS  records  were  read  for  one  ISSUE 
and  all  records  beyond  676  will  have  the  same  demand  node  name. 

Result:  Results  are  unpredictable. 
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MESSAGE  98  END  OF  DATA  FOR  PROCESS. 

Condition:  During  running  of  the  Apply  Policy  modules,  different  sets 
of  data  are  used  at  different  points.  Whenever  the  end  of  the  particular 
set  of  data  is  reached,  MESSAGE  98  is  output  to  signal  the  user  that  the 
end  of  file  was  needed. 

Result:  No  effect. 

MESSAGE  99  READ  OR  WRITE  ERROR  ON  UNIT. 

Condition:  A  read  or  write  error  on  the  unit  specified  has  occurred. 

The  reason  is  probably  that  the  file  has  disappeared,  is  not  available  for 
use,  or  the  file  name  is  misspelled  on  the  assign  and/or  use  statement  in 
the  runstream. 

Result:  The  programs  cannot  continue.  The  error  must  be  corrected  and 
the  programs  rerun. 

ERROR  103  MULTIPLE  DEFINITION  OF  ISSUE  FOR  THIS  UNIT.  RESETTING  ISSUE 
(warning  message). 

Condition:  The  unit  having  the  ISSUE  set  at  the  moment  has  already  been 
included  in  an  ISSUE  definition,  and  the  ISSUE  is  being  reset  from  the  pre¬ 
vious  ISSUE  to  this  ISSUE.  If  that  is  not  desired,  the  ISSUE  file  must  be 
corrected,  and  the  Set  ISSUE  program  rerun. 

Result:  ISSUE  has  been  changed  to  reflect  the  new  ISSUE  definition. 

This  message  is  a  warning  only. 

ERROR  104  THERE  IS  NO  SUMMARY  LINE  TITLE  FOR  ISSUES  (warning  message). 

Condition:  The  Report  processor  was  unable  to  find  the  "00"  level 
record  in  the  ISSUE  file. 

Result:  This  report  cannot  be  produced  unless  the  ISSUE  file  is 
corrected. 

ERROR  113  MINIMUM  ON  POLICY  FILE  IS  GREATER  THAN  1.0  (warning  message). 

Condition:  Merely  a  warning  that  the  minimum  percentage  from  the  Policy 
file  is  greater  than  100  percent.  Normally,  the  minimum  would  be  less  than 
1.0,  but  it  is  allowed  to  be  more  than  100  percent. 


Result:  The  minimum  is  used  as  stated. 
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ERROR  125  JOB-DATA  RECORD  CONTAINS  NO  JOBS  FOR  ISSUE  (warning  message). 


Condition:  If  this  message  is  output  from  ROLMOS,  it  means  that  there 
were  no  authorized  or  required  jobs  for  this  ISSUE  and  MOS  combination.  In 
other  words,  both  numbers  were  zero.  If  output  from  the  Apply  Policy 
program,  it  means  that  there  were  no  jobs  of  the  specific  type  of  data 
requested  in  the  Parameter  file  (authorized  or  required).  There  may  have 
been  required  jobs,  but  the  request  was  for  authorized,  which  was  zero.  It 
also  can  be  output  after  the  multiplication  of  the  Policy  or  Base  Value 
minimum  or  maximum  times  the  authorized  or  required  jobs.  Rounded  to  the 
nearest  integer,  it  might  turn  out  to  be  zero.  In  other  words,  fairly 
small  numbers  of  people  required  for  a  job  multiplied  times  a  very  small 
percentage  may  round  to  a  zero. 

Result:  The  data  is  dropped  from  the  data  base.  If  it  should  not  be 
dropped,  then  the  applicable  file  should  be  corrected  and  the  programs 
rerun. 

ERROR  126  JOB-DATA  RECORD  CONTAINS  NO  JOBS  FOR  UIC  (warning  message). 

Condition:  Similar  to  ERROR  125,  the  Job-data  record  contains  a  zero  in 
the  number  of  people  authorized  and  required.  The  program  that  outputs 
this  message  is  ROLMOS. 

Result:  The  data  is  dropped  from  the  data  base  by  the  program  ROLMOS. 
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